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WELCOME 
to The MagFi1 88 


etro Computing is always close to our hearts here at Raspberry 
Py Pi Towers. We grew up with all the greats: BBC Micro, Sinclair 
Spectrum, Commodore 64 and Amiga. 

No matter which classic system you prefer, we can all agree that retro 
computing on Raspberry Pi has never been better. 

With its faster processor and increased RAM, Raspberry Pi 4 can 
become virtually any 8- or 16-bit computer, enabling you to relive those 
glory years, rediscover classic programs, and learn computer science 
from the source. See our wonderful Retro Computing feature (page 24). 

Raspberry Pi 4 is a powerful computer — more power needs more 
energy, and that means more heat. The engineering team have been 
hard at work bringing down the heat, through clever tweaks that keep 
the speed levels up, but the heat demands down. 

We’ve expanded our heat tests for Raspberry Pi 4 and the result is 
a sublime Thermal Testing the Raspberry Pi 4 feature (page 66). It’s 
packed with insider information about how computers are made. 

Finally: Merry Christmas! Rob starts Christmas around October 
and has been working up to a big 
Christmas Lights tutorial (page 40) 
and the Top 10 Christmas Projects 
(page 80). Both are cracking features. 

I hope you all have a great holiday 
season, and make lots of amazing 
things. Don’t forget to share your 
projects with us! 


Lucy Hattersley Editor 


MagPi 
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Lucy 
Hattersley 


Lucy is Editor of 
The MagPi. Her first 
computer was a 
ZX Spectrum, but 
it was Commodore 
that stole her heart. 
First with the C64, 
then the Amiga. 
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. ender Balance 
In Computing 
programme opens 


Raspberry Pi Foundation rolls out scheme to study why young women 
don't choose to study computing. By Rosie Hattersley 


V Many young women 
don't choose to 
study computing- 
related subjects 


a UK-wide rollout of the Gender Balance in 

Computing (GBIC) programme. The GBIC 
programme launched in April to understand 
why many young women don’t choose to study 
computing-related subjects. “We are working 
with schools to understand which particular 
initiatives to address gender balance are most 
effective,” says Sue Sentance, Chief Learning 
Officer at the Raspberry Pi Foundation. 


T he Raspberry Pi Foundation has announced 


ac az 
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“We are drawing on existing research which 
points to a variety of influencing factors, including 
girls feeling like they don’t belong in the subject or 
its community, a lack of sustained encouragement, 
and a lack of role models in computing when 
making career choices,” she explains. 

The series of rigorously evaluated pilot 
interventions involving 15,000 pupils and 550 
schools will be the largest national research effort 
to tackle gender balance in computing to date. 

You can read more about the Gender Balance in 
Computing programme on the Raspberry Pi blog 
(magpi.cc/QbBrQ6). Schools can register for the 
scheme at magpi.cc/gbic. H 


A The Department for Education has funded the 
Raspberry Pi’ Foundation’s Gender Balance in 
Computing (GBIC) research programme 
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Next 


An iconic 8-bit computer is set to enjoy a 
retro revival with the help of ag Raspberry Pi 
Zero, as David Crookes explains 


n the 1980s, the ZX Spectrum range of 8-bit 

computers quickly became legendary. It 

boasted no more than 128kB of RAM (16kB 
on the original model), a Zilog Z8o0 CPU running 
at just 3.5MHz, and a palette of up to 16 colours, 
two of which were black. Yet the humble 
‘Speccy’ encouraged a generation of bedroom 
programmers and underpinned a flourishing 


Jim British video games industry. mel a tape decn can be plugged 
Bagley 35 ads into the Next, a full-size SD card 
Now it’s returning in a new, enhanced form , ; 
: contains the NextOS operating system 
Jinn nasbesn called the ZX Spectrum Next, and Raspberry Pi Zero and it can store games and other apps 
programming has proven invaluable in its development. “For me, 
e F Tee PSO UPE I FUT et 
games he goal has been to encourage a new generation of AY Cee My uh yey 
professionally for $5 DLA: SPA Shih y 
tine past 41 years bedroom coders,” says legendary games developer 
and he's a key Jim Bagley, who is among a group of Spectrum fans 
member of the behind the project. With 3113 Kickstarter backers was intended to be a normal Spectrum with an SD 
ae eae handing over £723,390 in cash, many others card and a Raspberry Pi Zero as an extender,” Jim 
ZX Spectrum. potentially share that dream. explains. “Raspberry Pi was going to be used to 
Work has certainly progressed well. “When add extra features such as hardware sprites and 
the Next was first announced three years ago, it hardware scrolling so that newcomers would find 
it easier to code the computer and get the wow 
factor of getting something running instantly on 


the screen.” 
During the Kickstarter campaign, however, 

a large field- programmable gate array (FPGA) 

was announced for the Next — a configurable 

integrated circuit which allowed the hardware 

sprites, scrolling, and other advanced features to 

be incorporated within the machine itself. “It freed 

up Raspberry Pi Zero to do something else,” Jim 

says. So the developers began to play around. 


Load and run 

One of the initial ideas was to recreate the feel of 
loading a game from tape — generating the series 
of scratchy, beepy, high-pitched noises which 


The ZX Spectrum Next contains a Z80 processor on an FPGA, 1MB of RAM expandable to 2MB, 7 ; 
hardware sprites, 256 colours, RGB/VGA/HDM| video output, and three AY-3-8912 audio chips could be heard as a program was ingested into 
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m The goal has been to encourage 
dg new generation of bedroom coders @ 


Rather than simply emulate the Spectrum, 
the Next uses a field-programmable gate 
array chip that acts as a Z80 processor 
with the addition of advanced features 
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ZX Spectrum Next 


LESSEE 


the computer. On the original hardware, this was 
accompanied by a loading image slowly building on 
the screen and animated stripy borders. 

Rather than have Next users connect a cassette 
deck, the developers had a cunning plan. “We 
thought it would be a good idea to have commands 
sent back and forth between the Next and 
Raspberry Pi Zero,” Jim says. 

This developed into a tool allowing a TZX file (a 
format that stores an exact copy of a ZX Spectrum 
tape) to be uploaded from an SD card to Raspberry 


ZX Spectrum Next 


Tare 


A It will work with CRT and VGA monitors, as well as More 
modern screens, thanks to the support of a HDMI output 


Pi Zero. By sending it back down to the new-gen 
Speccy through an audio-in pin, the Next would 
be fooled into thinking it’s loading a cassette. “It 
gives the original feeling of loading from tape,” 
Jim affirms. 


Having a Raspberry Pi Zero 
accompanying the Next 
has also enabled other 
gudio delights 


Are you there, SID? 

Having a Raspberry Pi Zero accompanying the Next 
has also enabled other audio delights. A Sound 
Interface Device (SID) emulator has been developed 
that allows audio created for Commodore’s SID 
programmable sound generator chip to be played 
on the Next. 

It will also be possible to enjoy Atari ST audio 
files and tunes created using music trackers on 
the Commodore Amiga. “We can send the audio 
through a GPIO pin and it goes straight to the 
FPGA, where it’s mixed with the audio of the 
Next,” Jim explains. 

To achieve all of this, the developers have 
used DietPi to create a new OS called NextPi. “It 


COREE 


LALLA LL LIOR 


CAN 


3 ee 


te~ 6: 


— Sa 


A Raspberry Pi Zero 
was chosen as an 
accelerator board 
for the ZX Spectrum 
Next because of its 
power and low cost 


remains a fully functioning Raspberry Pi Zero that 
is running at the same time as the Next, but we 
wanted the Next to be more in control.” 

The most recent extra use for the Next’s 
Raspberry Pi Zero is the ability to connect the latter 
to its own display. “It’s possible to send screens 
to Raspberry Pi Zero so that you can have a dual 
screen,” Jim says. “This means you could have a 
game being played on the Next, with a global map 
or stats shown via Raspberry Pi Zero.” 

The team is now looking to get USB controllers 
to work via Raspberry Pi Zero, allowing them to be 
read by the Next. “We'd also like Raspberry Pi Zero 
to help with 3D maths so you can take vertices, 
have them rotated, and passed back,” Jim says. 

In the meantime, the team is readying the 
new computer for a January release and a new 
Kickstarter is being planned for those who didn’t 
pledge the first time around. We’re certainly 
looking forward to seeing where it - and 
Raspberry Pi — goes next. 


The Next's 
keyboard/case 
design is based on 
the ZX Spectrum 128 


MaigPi 


Raspberry Pi emits 


Games in the file format TZX - a tape format 

used for preservation purposes - need to 
be saved on to an SD card and inserted into the ZX 
Spectrum Next. 


A game can then be selected via the Next 

computer's built-in Browser mode. Raspberry 
Pi Zero will be instructed to load the game's data 
from the SD card. 


Obata cissa i 


— WA claps 


Raspberry Pi Zero sends the data back to the 

ZX Spectrum Next as audio and this generates 
the once-familiar loading noise and loading screen 
ahead of the game running. 
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The Swirl Machine 


Make fantastic art with wine using The Swirl Machine. Rob Zwetsloot picks 
dg nice merlot and proceeds to ‘swirl his style’ 


Rob Gaedtke, 
Jonathan 
Rutheiser 


KPS3 is an 
integrated 
marketing agency 
that works with 
companies across 
the globe to find 
insights in data and 
bring them to life. 


magpi.cc/9yrkJW 


Warning! 
Spinning glass 


If you choose to recreate 
this project, please fix 
glass on a spinning 
turntable carefully (and 
at your own risk). 


D> Thousands of pieces 
of art have been 
created - is your 
piece on display? 


rt comes in many forms, and for this 
A project it takes the form of an interactive 

wine art creator called The Swirl 
Machine. It’s a lot more complicated than it 
might sound, though. 

“The Swirl Machine is an interactive, digital- 
meets-the-real-world machine that swirls Santa 
Maria Valley wine and turns it into a digital piece 
of art,” say the team from KPS3, the marketing 
agency behind The Swirl Machine. “It was created 
and developed by KPS3 for Visit Santa Maria Valley. 
The machine allows users to select their ‘Fill Level’ 
and ‘Swirl Speed’. In real-time, the user can watch 
the glass fill, swirl, and splash the wine onto a 
piece of paper, creating an original Santa Maria- 
style spill artwork. Every swirl and spill will be 
unique to each individual user.” 
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A sucker arm 
picks up paper for 
creating your art 


The wine glass is 
filled and swirled to 
your specifications 


It’s a bit like a Rube Goldberg device, albeit 
without the Powerhouse music playing. The result 
of your swirl is sent to you as a photo, and there’s 
even a fun personality result that comes with it. 

“The idea came on a car ride to Santa Maria 
Valley,” the KPS3 team explain. “The team was 
playing around with the idea of capturing slow- 
motion swirls, which led to how interesting wine 
spills are, and that led to The Swirl Machine. The 


M In real-time, the user can 
watch the glass fill, swirl, 
and splash the wine onto 
g piece of paper 


fact that it was a spill fit perfectly into the vibe 
of Santa Maria Valley’s wine experience... if you 
spill a little, no one really cares. And because of 
who KPS3 is as a company, it clearly had to push 
technical boundaries.” 


Making a splash 

At the time of writing, there have been around 
2000 ‘swirls’ on The Swirl Machine’s website 
(magpi.cc/9yrkJW), and the machine has been 
made possible thanks to a Raspberry Pi. 


Your art is affixed 
A here for its close-up 


> The video of a 
user's swirlcan 
be replayed 


> The Swirl-nalysis 
takes into account 
the final art and 
your settings 


> The queue lets you 
watch the swirls 
ahead of you 


>» More than 1600 
people have 
created about 
2000 swirls 


> Artis very cool, 
however you 
make it 


<4 We love the arm with 


an air compressor 
that sucks up paper 
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Swirl your style 


SWIRL 
SETTINGS 


First, you need to select how full the wine 

glass is. This tells the pump how much wine 
to dispense into the glass. You can also choose the 
amount of ‘swirl’ for your glass, which sets a target 
speed for the spinning wine plate. 


A The complete machine 


is a masterpiece of “We like Raspberry Pi because it has a very low 
messy aut alia Inany barrier to entry,” the KPS team say. “For only 
electronics 


$35 you get a fully functioning computer with I/O 
capabilities. The community behind Raspberry 
é j Pi is also active and helpful, which means you 
powered suction cup grabs your piece of 
special paper. It brings it to the paper holder, where get software packages that are thoroughly tested 
the paper is then moved into position. Wine is and you never spend too much time figuring out 
dispensed, the glass is spun, and art happens. solutions to problems. We’ve used Raspberry 
Pion many different projects in the past [...]. 
Whether it’s powering a media server, emulator, 
i live-streaming client, or The Swirl Machine, we 
know it’s more than powerful enough to handle 
4 = the tasks we’ve thrown at it.” 
: The machine uses a number of technologies. 
' The website is hosted in AWS. A robot arm grabs 
paper and moves it along the swirl production line. 
Arduinos control the wine glass, and a spinning 
plate swirls the glass. Each piece of wine art 
Y is unique, including the corner splash that we 
managed to make during our go with it. Hl 


Agripper arm with an air-compressor- 
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Acamera records the footage of the swirl, and 
a different camera takes a picture of the final 
piece. As the wet paper isn't perfectly straight, the 


image is processed to make it look perfect before > A Raspberry Pi 
being shared with the creator. takes photos of the 
final piece 
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Use Raspberry Pi 4 as a desktop 
PC and 4K home media centre 


Be inspired by incredible 
projects made by other people 


Learn how to code and make 
with our step-by-step tutorials 


Find out about the top kits and 
accessories for your projects 
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A typical night in Joe's 
driveway in Alabama. He's 
lucky to live somewhere 


with little light pollution The project's Raspberry 
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The tracking scope is mounted to the 
top of the primary telescope. There are 
two cameras: a CCD on the tracking 
scope and a DSLR on the primary scope 


Joe 
Kutner 


Joe Kutner (aka 
Codefinger) is a 
software architect 
at Salesforce.com, 
where he works 
primarily with 

Java and other 
open-source 
technologies. He's 
published several 
books about 
programming with 
Ruby and Java. He 
enjoys amateur 
astronomy, mostly 
observationally, but 
he also dabbles in 
astrophotography. 
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Pi is at the base of the rig, 
and has a touchscreen 


Autogulder 


The awe-inspiring wonders of the night sky encouraged a keen stargazer to 
find a better way to capture their beauty. Rosie Hattersley gets inspired 


reating stunning photographs of the 

night sky requires planning, patience, 

and reliable star-tracking equipment. A 
desire to travel a little lighter led keen amateur 
astronomer Joe Kutner to embark on his first 
Raspberry Pi project. 

Joe says there’s nothing worse than taking hours 
of astrophotography images only to find out your 
telescope was drifting, causing the stars to look 
more like lines than points. To protect against this 
kind of misalignment, he needed an autoguider: 

a computer and camera that track a star in the 
telescope’s field of view to ensure that it stays in 
the same position throughout the session. 

“The main goal of my project was to get rid of 
the laptop,” Joe tells us. “I needed to control my 
telescope in the field. I spend enough time in front 
of a computer at work, and the laptop took the fun 


Astrophotography Autoguider 


out of observing. It served an important function, 
though: controlling both my camera and my 
mount. Without it I would only be able to take very 
short exposures of the moon and planets.” 

Joe considered using an iPad or a Microsoft 
Surface instead, but both were far too expensive. 
He wanted to keep the build cost below $100, and 
neither worked well with his chosen software. 

Instead Joe picked up a Raspberry Pi, a case, and 
a touchscreen for less than $100, and added a red 
plastic cover so he was still able to use the setup 
in night-vision mode. These work alongside the 
various bits of astronomy kit Joe uses regularly on 
his stargazing missions. 


Under open skies 
Joe made extensive use of general purpose open- 
source software such as Raspbian Stretch and Git, 
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head Nebula and Flame Nebula, 
photographed from Joe's Alabama driv 
the help of his Raspberry Pi itrolled autoguider 


spberry Pi in a case 
vith a red pl lay 
so it can at night 


Astrophotography Autoguider 


Raspberry Pi 
records over 
several hours 
while Joe sleeps in 
his tent 


Joe recommends 
Lacerta MGEN II 
(magpi.cc/3XGdSW) 
if you don’t want to 
build your own 


Many of his 
astronomy photos 
are taken from 
Huntsville, Alabama 


He's using 
Raspberry Pi to 
attempt to image 
an exoplanet transit 


He also blogs about 
coders’ fitness 

and nutrition at 
healthyprog.com 
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A Lagoon Nebula (N ier 8), a giant interstellar 
cloud located in the constellation of Sagittarius 


A Whirlpool Galaxy 
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plus astronomy-specific open-source tools Libnova 
(magpi.cc/libnova), INDI (indilib.org), and PHD2 
(openphdguiding.org) telescope guiding software. 

He wrote scripts to automate the software so he 
could just use the touchscreen, without a mouse 
or keyboard. But for the most part, things worked 
without customisation. 


M1! can roll it onto my 
driveway and start imaging 
in just a few minutes 


“Every step in the process had its challenges,” 
Joe recalls. “I would install one piece of software 
and then find out it wasn’t compatible with some 
version of another piece of software I needed. 
When I finally got everything running, it wouldn’t 
talk to my telescope until I installed yet another 
version of the software. There were dozens of 
these little paper-cuts, but in the end it was worth 
working through them.” 

Joe also says the hardware he chose worked 
perfectly from day one. Any tweaks he made were 
“mostly minor issues like figuring out how to install 
the correct version of a particular camera driver”. 

His Raspberry Pi now has an on-board 
autoguiding system for his astrophotography rig. 
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Build an autoguider 


Aust 


Start with a fresh installation of Raspbian 

and download the package for libnova 0.14. 
You can find the install instructions at Joe's GitHub 
page (magpi.cc/Xn4JCE). 


Tui a Rangiberry PY onto an Astrephosograpy 
loguider 


Because Raspberry Pi attaches to the base of the = Pree peace al 
mount, it’s easily accessible. Unlike using a laptop, oie eee easy to 
there’s no need for an extra table or complicated 

wiring. Joe says the setup is perfect for his needs: 

“T can roll my telescope onto my driveway and start 

imaging in just a few minutes.” 


Use the GitHub instructions to build INDI, 
the software to connect Raspberry Pi to your 
digital camera and mount. Install the Atik camera 

driver if needed. 


International expansion 

Now that Joe has successfully built a fairly portable 
astrophotography rig, he sees its potential for 
explorations further afield. He’s keen to try out his 
autoguider with other types of astrophotography 
kit such as the ultra-compact Sky-Watcher Star 
Adventurer series of mounts. “When combined 
with my Raspberry Pi,” he says, “I could take the 
whole rig on an airplane as carry-on. That would 
give me access to some very dark skies.” [il 


Install and build PHD2 autoguiding software, 
then start the INDI server so it looks for 

the camera and mount. Save the profile for 

future reference. 


0 Lacerta MGEN Ilis a 
good alternative if you 
don't want to build your 
own autoguider 
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» Great Savings 
Save up to 35% compared to stores 


» Low monthly cost (from £5) 


» Cancel at any time 
» Free delivery to your door 
Available worldwide 


£55 (UK) £90 (USA & Rest of World) 
£80 (EU) 


Free Raspberry Pi Zero W Kit with 12 Month upfront 
subscription only (no Raspberry Pi Zero Kit with Rolling 


Monthly Subscription) 


® Subscribe by phone: 01293 312193 
© Subscribe online: magpti.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 
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RETRO 


COMPUTING 


with br 
RASPBERRY PI4 ji 


Want to rediscover the golden years of computing and enjoy x 
a bit of classic gaming? Go old-school with PJ Evans 


odern computers like Raspberry Pi 4 are 
amazing, but sometimes we yearn for an 
earlier time with 8-bit processors, and either 
BASIC language or machine code. A time when computers 
were stripped back, with simpler architecture that required 
deep understanding. 
Quite possibly it is this, rather than straightforward 
nostalgia, that fuels the healthy retro computing scene. 
Retro computing is also a playground for makers, 
providing endless inspiration for projects and supported by 
a wealth of open-source software. Over the next few pages 
we’ll fire your imagination by looking at building your own 
retro computer, whether it’s revitalising old tech or coming 


up with a new design. We’ll also try to answer that age-old ee re el 
question: what to do next? 


In this feature, we’re going to look at upcycling vintage 
computers, building retro games consoles, playing retro 
games, and classic programming. Let’s go back in time. 
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Upcycle a vintage Build a DIY Great gaming Get hold 
computer arcade console essentials of games 
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UPCYCLE A 
VINTAGE COMPUTER 


Don’t bin an old computer — give it a new lease of life with Raspberry Pi 


& The delicate ribbon 
connectors form 
part of the matrix 
system that detects 
key presses 


adly, not all tech is built to last and it’s 
S quite easy to pick up an expired 1980s 

home computer. You may not be able to 
save the circuitry, but if the case and keyboard 
are good, you might just have a great project for 


a Raspberry Pi computer. Add some emulation 
software and you’ve got a modern take on a classic. 


Find a willing donor 

Whichever old computer you elect to 
upcycle, the biggest task will be wiring in the 
keyboard so it can be used by Raspberry Pi. You 
may find that the keyboard has more inputs than 
Raspberry Pi’s GPIO can handle, so you’ll need 

a microcontroller such as an Arduino Leonardo 
(magpi.cc/jbuEh9) to act as a USB interface. Please 
do not destroy a working computer. We’ve chosen 
a mid-eighties ZX Spectrum+. 


Map the keyboard 

Requiring a GPIO pin for every key would 
be unmanageable. Luckily, most vintage home 
computers use a simple row-and-column matrix 
system to reduce the number of pins used. Electrical 
pulses are sent down each column in sequence and 
if a key is being pressed, the column and one of the 
rows will form a circuit. Now we can calculate which 
key has been pressed. Using a bit of Python, we can 
replicate this and feed the results into Raspberry 
Pi as if it were the keyboard. Most computers, 
including our ZX Spectrum (magpi.cc/MwGP33), 
have their matrices detailed online. 


03 Make a keyboard adapter 
Most keyboards use two ribbon cables, one 
for the row and the other for the columns. Select a 
spare GPIO pin for each and build a simple adapter 
to securely connect the keyboard to Raspberry Pi’s 
GPIO interface. For a ZX Spectrum, this requires 
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the sourcing of two Molex connectors (relatively 
easy to source online - see magpi.cc/molex) 
and some pieces of stripboard to solder in the 
connectors, and some wiring to connect to the 
GPIO. The column side (KB2) will need diodes on 
each line to avoid short-circuiting. 


Prepare your computer 

If you haven’t done so already, now is the 
time to get your operating system set up. We’re 
using Raspbian Lite as we can run our emulator 
of choice using SDL (Simple DirectMedia Layer, 
libsdl.org), which is a fancy way of saying we don’t 
need the weight of a full desktop install. On the 
command line, make sure everything is up to date 
ussbeteqsudo apt -y update && sudo apt -y upgradek 
then install the dependencies: 


sudo apt install python3-pip 
pip install pynput 


a 
Add some Python 
Now the keyboard is connected to the 
GPIO, it’s time to test it out and make sure we can ae 
get input into Raspbian. Download the Python 
script from magpi.cc/YwTF¢gr by issuing the 
p gpi.cc/ gr by g eel 


following commands: 


git clone https://github.com/mrpjevans/ 


zxscanner2.git 


cd zxscanner2 


Now run a simple test by running this command: 


sudo python3 test_keyboard.py 


Press a few letters on the keyboard. Do you see 
results? If not, check all your wiring. If you’re 
happy, edit the file keyboard_scanner.py 
following the instructions to get the correct ‘map’ 
for your chosen computer’s keyboard. 


Raspberry Pi 4 can easily emulate the 
ZX Spectrum, and its connectors match 
the expansion aperture perfectly 


06 Background 

To make best use of the keyboard, we need to 
have the keyboard scanner run at startup and sit in 
the background. To do this, create a system service: 


sudo nano /usr/lib/systemd/zxscanner2. service 


Add the following text: 


[Unit] 
Description=ZX Scanner 
After=multi-user. target 


[Service] 

Type=idle 

ExecStart=/usr/bin/python3 /home/pi/ 
zxscanner2/keyboard_scanner.py 


[Install] 
WantedBy=multi-user. target 


Now enable the service so that it always runs on boot: 


sudo systemctl enable /usr/lib/systemd/ 
zxscanner2.service 


sudo systemctl start zxscanner2.service 
sudo systemctl daemon-reload 


The ZX Spectrum was a mainstay 
of the 1980s home computer 
revolution and sold millions of units 


“ 


07 Install an emulator 
Once happy that your keyboard is working 
as expected, get your emulator running. For the 
ZX Spectrum there are a few options, including the 
easy-to-install Lakka. And a standalone favourite 
is FUSE - installed directly from the command line: 


sudo apt install unclutter fuse-emulator-sd1l 


If you’re using Raspbian Lite, however, you may 
need to build a version of FUSE that doesn’t need 

a graphical user interface. See the website for full 
instructions (fuse-emulator.sourceforge.net). You 
set FUSE to run on boot for an authentic experience. 


08 Make it your own 

Just because it’s a ZX Spectrum, doesn’t 
mean we’re restricted to just one emulator. Annoy : —_—_ 
pedants by running VICE64, a Commodore 64 
emulator, or even arcade emulators like MAME. 
Why not add a Bluetooth controller to play joystick 
games? For a more authentic experience, tap into 
the composite video connector on Raspberry Pi 4B 
to give slightly fuzzier output - modern displays 
are just too precise to be authentic for the ZX 
Spectrum. Whatever you decide to do, have fun 
with your newly revived vintage computer. 
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How one young maker built a retro games console 


Jamie is 14, from 
Milton Keynes, anda 
STEM enthusiast. 


Some clever thinking 
and attention to 
detail makes for 
a beautiful retro 
gaming console 


ome amazing projects come out of after- 
» school clubs. Some even win awards. 
W When Jamie, a young maker, brought 
this gorgeous retro gaming console to the Milton 
Keynes Raspberry Jam, we had to know more. So 
we asked him a few questions... 
yuild this project 


) id you cor d this proj 
Last school year, when I was attending our school’s 
science club, we were asked to go for the bronze 
STEM (science, technology, engineering, and 
mathematics) award. I was considering several 
project options but, in the end, I decided to build 
an object using Raspberry Pi and apply most of the 
disciplines of STEM. 

Ihy did \ u cl YVUSC ) 3 = 
When I searched the internet for Raspberry Pi 
projects, retro games consoles seemed to be the 
most popular. I discovered RetroPie! I watched a 
few people on YouTube running RetroPie and it 
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The case may be chunky, but it's a great example of building a 
unit with arcade joysticks and buttons 


looked like good fun. I wanted the project to appeal 
to adults (who remember those games) and to kids 
so they can see what gaming was like before Xbox 
and PlayStation. 


What are you most happy alt iTS 

I built my own games console. It was an 
achievement; I was well chuffed! The external 
design of the console is unique to me. I have 
assembled several advanced Lego / Meccano 
models over the years, but this was my first build 
using Raspberry Pi. I was also very pleased about 
the reaction and the attention it received from my 
classmates and friends. 


LIE PILOJCCle 
The biggest challenge in this project was cutting 
the holes for the control buttons on the top panel 
and the side of the case. We had to do the top panel 
twice as, at the first attempt, the acrylic cracked. 


The second biggest challenge, to my surprise (and 


We look at the hardware 
here, but what about 
software? We've chosen 
Lakka, an extension of 
the RetroArch emulation 
software - which 
provides a single point of 
configuration for multiple 
emulation systems, 
rather than having to deal 
with multiple diverse 
applications. Not only 
does Lakka run well on 
Raspberry Pi 4, but it’s 
available for Windows and 
Mac too. Check out our 
Lakka tutorial on page 52 
for how to set it up. 


“ THE BIGGEST 
CHALLENGE WAS 
CUTTING THE 
HOLES FOR THE 
CONTROL BUTTONS” 


others), was finding the correct driver software 
for the Picade X HAT. Assigning the joystick and 
buttons was also tricky. 


Do you have a next make planned? 

My next idea is to produce a Raspberry Pi cluster 
made using Raspberry Pi 4 with a repurposed 
digital photo frame for a screen. I am also 
looking into upgrading my retro games console 
with a Raspberry Pi 4 to see what difference it 
will make. 
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Vintage computer magazines often 
carried code alongside news and 
reviews of the latest technology. You 
can read many classic magazines on 
archive.org and other websites. Here 
are a few of our favourites: 


There's some great code to play around 
with in Your Spectrum magazine and 
the early issues of Your Sinclair. 


Focused mainly on Commodore 
computers, Ahoy! had a range of high- 
quality tutorials for Commodore 64 and 
Amiga machines. 


This magazine launched alongside the 
BBC Micro and offered a wealth of classic 
computing articles and type-in programs. 
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TEN GREAT 
GAMING ESSENTIALS 


For the proper experience you need the proper equipment. 
Here’s some of our favourite retro computing kit 


RGBPi €30 (£30) | rgb-pi.com 


There’s a lot of debate over display choices for 

| retro gaming. Many prefer modern technology and 
razor-sharp pixels. The fact is that a lot of 1980s 
and 1990s games were designed to be viewed ona 
CRT display, with ‘fuzziness’ taken into account. 
So, to see the games as the designer 

intended without having to 
compromise too much, add —EE 
an RGBPi to your system. This frvesny 
add-on creates an old-school 

SCART RGB signal from 

Raspberry Pi’s GPIO, making 

it compatible with most 

CRT colour TVs - and there’s 

plenty of the latter on auction sites. 


Cool Retro Cases 


SBitDo joysticks From £35 | magpi.cc/8bitdo 


Controllers are another facet of retro where the old and modern collide. 
You want to use a genuine joystick from the era of course, but many are 
fragile or, well, a bit rubbish by today’s standards. Also, why not take 
advantage of Raspberry Pi Bluetooth and go wireless? 8BitDo’s range of 
retro controllers is an elegant solution to this dilemma: all the advantages 
of modern engineering, available with Bluetooth, in a range of classic 
stylings to match your case. You can even use them with your PC, as more 
recent features like rumble are supported. 


Picade 


© computing with Raspberry Pi 4 


» 


ye 


Clear Deluxe Arcade 
Controller Kit 


Wireless USB Gamepad 


£14 | magpi.cc/wirelessgamepad 


If you’ve ever attended a big Raspberry Pi robotics 
event such as Pi Wars, then chances are you’ ll 
already be familiar with this little device being used 
to drive things about. Pi Hut’s budget controller 
plays well above its price league, featuring a D-pad, 
shoulder buttons, and two analogue controls ina 
sturdy package. As it uses an RF USB connection 
rather than Bluetooth, setup is a matter of plug- 
and-play. It’s well supported by all the popular 
gaming environments, such as RetroPie and Lakka. 
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Joysticks and buttons 


From £2 | magpi.cc/Jx6AKs = - 6 


The popularity of retro gaming has led to a vibrant market in components, 
and that means lower prices. If you’re planning on a console or cabinet build, 
you’re going to want sturdy and accurate input devices. Kits and components 
are widely available, many coming from original moulds and tooling used 

to build arcade equipment but with improved design and more durable 
electronics. A full set is surprisingly affordable and will also do for restoring 
any original equipment you’ve managed to acquire. Regardless, for any DIY 
project, you’re going to want that original button-mashing sensation. 


LACK Table 


JAMMA board €50 (£50) | rgb-pi.com 


If you can find a genuine cabinet from the golden era of arcades, you’re a 

very lucky person indeed. Don’t despair if it’s not working. If screen and 
controls are intact, why not add Raspberry Pi! Most 1980s arcade machines 
used a standard interface, JAMMA, to connect the logic board to inputs and 
outputs. The Raspberry Pi JAMMA board adapter enables anyone to bring an 
old cabinet back to life, hooking 

upthedisplayandcontrolsto NAOH) GUOHERURURERRUQURURRL, 
the GPIO. Add RetroPie and eee aase tla ey Py 
you’re running thousands of = t= 
games on original equipment. 


FreePlay Zero Kit 
| 
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You've got the kit, but what to play? 
Welcome to the world of homebrew 


f you think retro gaming is just about old 
games, then we’ve got some great news. 
4. Thanks to the ‘homebrew’ scene, new 


Original games rub shoulders with ‘demakes’, 
modern games on old systems. We’ve picked 
a few of our favourites and provided links for 
finding out more. 


He ern ATCM 3 


20!) CTCCANI tamer 


gt 


Free / Name your price magpi.cc/hibernated1 


In Stefan Vogt’s adventure you play Olivia, awakened from hibernation 
when an alien spacecraft traps her ship, Polaris-7, in a tractor beam. 
With no communication from the other craft and surrounded by death 
and decay, can she escape? This is a text adventure in the classic style 
and the opening chapter in an ongoing series. 
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games for old systems are appearing all the time. 
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Free magpi.cc/nohzdyve 


Charlie Brooker’s Black Mirror episode 
‘Bandersnatch‘ made headlines with its 
innovative ‘choose your own adventure’ 
format. It’s riddled with references to the 
home computer scene of the 1980s, ‘Tuckersoft’ 
being based on Liverpool powerhouse Imagine. 
ZX Spectrum enthusiast Matt Westcott was 
commissioned to bring one of the featured 
games to life. 


] r 


Free | magpi.cc/halo2600 


Yes, you read that correctly and yes we are talking 
about Microsoft’s legendary Halo franchise. 
Remarkably, unlike many demakes that can 
infringe copyright, this version was written by Ed 
Fries, leader of the original Xbox project and has 
been given Microsoft’s blessing. Some cartridges 
were manufactured by AtariAge, although you can 
download the game for free. 


Ze. 
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Teeter Torture 


Free | magpi.cc/teetertorture 
PLATFORM: MAME 


This game is an original from 1982 which has now 
been released free of charge for non-commercial 
use by Exidy. It has mysterious origins and only 
one cabinet is known to exist, which luckily still 
works! You control a cannon on a trolley that 
balances on a barrel of TNT. Shoot the aliens or 
they’ll topple you over, triggering the detonator. 


ae oe co 
SCOREOG7530 (_——S™BONUSx0e ZONES #1 


Relentless 64 
| 


PLATFORM: Commodore 64 


HOMEBREW 
DESTINATIONS 


Need more games for your console? 
These sites are full of homebrew 


and legal downloads 


2 


‘The oficial world archive for the Sinciatir ZX 
Spectrum and the largest on-tire gaming center 


Recreate Soectrwm App We are aware that the Recevaled Spectium keyboard me longer hae the 
app weaported by Elite. We have 2 copy here for download for the andrekd verw 


World of Spectrum 


The admins of this site have been thorough in 
getting clearance to host the many thousands of 
games available. 


worldofspectrum.org 


MAME Official Site 


A selection of legal ROM downloads of classic 
arcade machines. 


mamedev.org/roms 


Vintage Is The New Old 


A massive collection of homebrew software for 
many different platforms. 


vintageisthenewold.com 


Homebrew Legends 


Acommunity-focused site that is essential for 
keeping up with the latest releases. 


homebrewlegends.com 
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Warning! 


It is illegal to download 
copyrighted ROMs from 
the internet. The MagPi 
does not endorse video 
game piracy and strongly 
recommends you stick 
to emulators that do 
not use any protected 
software, such as BIOS 
files, and stick to game 
downloads that are 
offered with the consent 
of the rights holder. 
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yj THE OFFICIAL RASPBERRY PI MAGAZINE 


FROM THE MAKERS OF Ma 


ALD 


RETRO GAMING | 


a 


RASPBERRY PI 


Retro Gaming with Raspberry Pi shows you 
how to set up a Raspberry Pi to play classic games. 
Build your own portable console, full-size arcade 
cabinet, and pinball machine with our step-by-step 
guides. And learn how to program your own games, 
using Python and Pygame Zero. 


= Set up your Raspberry 
Pi for retro gaming 

= Emulate classic 
computers and consoles 

= Learn to program 
retro-style games 

= Build a portable 
console, arcade cabinet, 
and pinball machine 


BUY ONLINE: magpi.ce/store 


WE Magri | TUTORIAL 


Danny Staple 


Danny makes 
robots with his kids 
as Orionrobots 

on YouTube, and 

is the author of 
Learn Robotics 
Programming. 


orionrobots.co.uk 


Warning! 
Drill safely 


Please use safety 
goggles and a desk 
clamp when drilling 


[ You'll Need 


» Raspberry Pi 
Camera Module 
magpi.cc/h5XSDp 


» Pi Zero Camera 
Cable adapter 
(10-15 cm length) 


» Hand drill with 8mm 
and 2.5mm bits 


» 2.5mm nylon bolts 
and nuts 


» Needle files 
(up to 8mm) 


Add a camera to 
your low-cost robot 


See the world from a robot's eye view by adding a camera to it 


camera is an exciting accessory to give 
A to a robot. First, you will be able to see 

the world from the point of view from the 
robot, creating a mobile periscope or debugging 
your code from this view. However, a camera also 
opens up the possibility of processing an image 
and using it as a sensor in the robot. 

In this part, a camera will be securely mounted 
onto the Lunchbox robot, attached to the 
Raspberry Pi, and you will get the first images 
from it. 


Planning out 

Find a sketch of the camera and make a 
cardboard replica to test fit this in the robot. The 
camera is upside-down, so its cable is clear of 
Raspberry Pi. 

Make a drawing of the front of the robot with 
dimensions to add camera holes. Make a vertical 
dashed line for the screw holes and sensor at 
14.5mm plus clearance from the base. 17.5mm 
works with 3mm clearance. 


Front Of Robot Camera 


He 34.5 mm —>fe 21 mm >} 


A Make sketches of the front of the robot, the camera 
(using the net), and dimensions to position any holes 
Shade where holes will be 
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At the horizontal middle of this line, draw the 
8mm square hole for the lens, with mounting 
screws either side by 10mm. These have a2mm 
diameter. Two screws are enough for the camera. 


Some disassembly required 

A space behind the front of the robot is 
needed to make the camera holes safely without 
breaking anything. Remove at least one battery 
from the robot to prevent short circuits. 

To keep wires tidy, use tape to group bundles of 
sensor grounds, sensor Vcc, sensor signals, and 
battery power. Mark them to help. Unplug these 
from the breadboard. 

Unscrew the battery leads and remove the 
top of the robot. Now unscrew its Raspberry Pi, 
keeping the screws for later. Lift Raspberry Pi and 
breadboard out and to the side of the robot. 


Marking out 
Use the sketches, a ruler, and set square to 
measure and mark out where to drill the holes. 

Start with the height first and carefully use a 
sharp tool, like a maths set compass, to scratcha 
horizontal line for the height of holes, and another 
for the camera. 

Use a ruler across the horizontal; scratch marks 
for the 8mm camera hole centre, and then 10.5mm 
either side of this for screw holes. 

The front panel should now have three crosses 
scored into it, one for each hole. 


Drilling the holes 

Wear goggles for this step 
With the 2mm holes, use the 2mm drill bit resting 
in the cross. Start slowly and speed up as the tool 


A few holes make 
a secure mount 
fora camera 


Connecting 
the camera to 
Raspberry Pi 


> , Taping up bundles of cables with 
a 
B0€S through. Don’t drill too deep and into the similar functions makes them tidier, 


electronics behind. Support the plastic, but never and makes them easier to reconnect 
put fingers where the drill bit is going. Robot parts 
are more replaceable than fingers. 

For the 8mm hole, start with the 2mm bit, but 
then work up through sizes to the 8mm bit. If the 
holes are rough, let the drill bit spin and move it 
back and forth through the hole to clean it up. 


PL 


Not every robotics task is 
glamorous, and filing 
away plastic can take 

dg while 


Making a square hole 

The 8mm hole is round, and Raspberry Pi 
Camera Modules need a square hole. Not every 
robotics task is glamorous, and filing away plastic 
can take a while. 

Push a flat needle file gently through the middle 
of the 8mm hole, work it back and forth until it goes 
through smoothly, then file one side to make the 
shoulders of the square. Repeat for other sides. 

Measure and repeat until it’s square and 8.5mm 
each way. When it looks right, try fitting the 
camera — remove to scrape more if needed. The 
screw holes should line up around the lens. 
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TopTip & 


Letting the 
drill glide 


Do not push or 
force a drill. It 
should cut its 
way through and 
glide into a hole. 
Go slowly to 
avoid snags. 


V The large hole for 
the camera should 
be filed square for it 
to poke through, This 
will need patience. A 
rotary tool could help 


Attaching the camera cable 

The camera has a connector for a cable to 
attach it to Raspberry Pi. The adapter cable is flat, 
with a wide end for the camera and a narrow end 
for Raspberry Pi Zero’s connector. 

The cable is less fiddly to attach before bolting 
the camera in place. Slide the plastic securing tab 
on the camera connector into the out position on 
the camera. 

Ensure the contacts (metal bits) at the wide end 
of the cable face into the camera board, then push 
gently into the connector, ensuring it is straight. 
Slide the plastic tab in to secure it. 


07 Fitting the camera 
With the camera removed, push the 2.5mm 
screws through from the front. Now line the 
camera up behind the screws and push it on, with 
the cable facing upwards. 

If the lens and screws don’t align, take note of 
where the overlap is and adjust the lens hole by 
filing more. Adjusting and fitting may take a 
few attempts. 

Once the camera fits well, put the nuts in from 
behind and gently turn them. Tighten them up 
only a little, taking great care not to over-tighten 
against the robot. The camera should be firmly 
attached, but not crushed. 
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Plugging the camera in 

The narrow end of the cable goes into 
a Raspberry Pi Zero. Partially manoeuvre your 
Raspberry Pi back into the robot, but leave space to 
work and get the to the camera connector. 

Raspberry Pi Zero has a somewhat fragile 
retaining clip on the camera connector, so take 
care when loosening this. 

Make gentle bends (no kinks) to comfortably 
get the camera ribbon cable to go face-up into the 
connector on Raspberry Pi. 

Gently push the cable into the connector with 
the contacts (metal parts) facing the top of the 
clip. Push the retaining clip back in carefully. 


M Gently push the cable into 
the connector with the 
contacts (metal parts) 
facing the top of the clip @ 


Reassembling the robot 

At this point, the robot’s Raspberry Pi Zero 
can be put into place and bolted back into the 
robot. Above this, the breadboard is lowered in. 
Make good any electrical connections on this layer 
that were disconnected or came loose. 

Reconnect the top layer sensor and power cables 
to Raspberry Pi’s GPIO header and breadboard. 
The previous code used BCM pins 13 and 26 for the 
top sensors. Verify the polarity of reconnected 
power cables. 

Place the top of the robot back on, ensuring not 
to catch any wires and that the camera cable is not 
being distressed. 


A After drilling, the camera mount area should look like a bit 
like this. It may need filing to remove rough edges 


A Gently slide the clip from the camera. Gently push the cable in 
straight. The contacts should be facing into the camera board 


Configuring the camera 
Turn on the robot and connect to it. Once 
connected, type the following: 


sudo raspi-config 


Typing this starts a configuration menu. Using the 
up and down arrows on your keyboard, move to 
‘Interfacing options’. Press ENTER to select this. 
Choose ‘Camera’ on the next screen and select 
‘yes’, then ‘Ok’. Press the ESC button on your 
keyboard to exit. 

Enter sudo reboot to restart this Raspberry 
Pi, so the camera is ready to use. Wait a couple 
of minutes for it to reboot, and then use SSH to 
connect to it again. 


Taking a first picture 

The raspistill tool can be used to get the 
first picture and ensure the camera is correctly 
installed. From Raspberry Pi SSH connection, enter 
the following: 


raspistill -o test_image.jpg --vflip 


This asks the camera to take a picture. The -o 
option says to store the output in the file 
test_image.jpg”. The --vflip option flips it 
vertically, as the camera is mounted upside down. 

Depending on light conditions, it should take a 
few seconds and return without an error. You can 
use SFTP software, as shown at magpi.cc/6PK7Bd, 
to copy the picture back to view it. 


Troubleshooting 
If raspistill fails to capture an image, read 
any error messages carefully for information. 

If cables need to checked, turn off the robot with 
sudo poweroff. Check the camera connections, 
ensure they are the correct way up on both ends, 
then try retaking a photo. 

Fresh batteries are needed if the robot loses 
power taking a photo. 

Acommon problem is a tiny ‘sunny’ connector 
on the front of the camera. Check if it’s loose and if 
so, carefully push it back in. 

Also, ensure you have used the raspiconfig menu 
in Step 10 set up and rebooted before trying to 
obtain an image. H] 


1 Change User Password Change password for the current user 
2 Network Options Configure network settings 

3 Boot Options Configure eaeest for start-up 

“ 

6 


Localisation oe Set in coches oe antes to match a 
‘Overclock Configure overclocking for your P: 


heap Options Configure advanced settings 


z 
8 Updet Update this tool to the latest version 
9 About meaielecoarig Information about this configuration tool 


<Select> <Finish> 
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Unclip Raspberry Pi's 
camera connector 
very carefully (it is 
fragile). Slide in the 
connector with the 
contacts facing up. 
Gently push in the clip 


TopTip & 


Help, I'm running 
out of space! 


Replacing 
breadboard with 
soldered stripboard, 
the L298N with a 
DRV8833 or motor 
HAT, and putting 
motors outboard 
are ideas to free up 
space in the robot. 


In raspi-config, select 
Interfacing options, 
then Camera, 

and select Yes to 
enable it 
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Rob 
Zwetsloot 


Rob is amazing. 
He's also the 
Features Editor 

of The MagPi, a 
hobbyist maker, 
cosplayer, comic 
book writer, and 
extremely modest. 
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Flexible 
NeoPixel lights 
magpi.cc/iP97nc 


USB microphone 


Python 
SpeechRecognition 
library 
magpi.cc/Sb2vkB 


Push-button 


5V power supply 
(batteries or PSU) 


220 Q resistor 


Smart Christmas 


tree lights 


Bored of normal Christmas lights? Hack your Christmas tree 
with a Raspberry Pi and make it festively voice-controlled! 


to decorate. Over the years, we’ve made 

Christmas tree stars, normal tree lights, 
and even a light-up card you can make out of the 
cover of issue 52! 

This year, we’re heading back to the tree lights 
to give them an extra ability: voice-controlled 
lights! We’ll be doing this using a slightly 
easier method than other audio services, so you 
won’t need to sign up to any Amazon or Google 
developer accounts. Let’s get festive! 


C hristmas is here, and that means it’s time 


The right lights 

For our specific build, we’ re using 3 m of 
RGB NeoPixels with 30 LEDs per metre. You can 
find the ones we used here: magpi.cc/iP97nc. 

These may not be the right lights for you, 

though. While we think 144 lights per metre is a 
bit much, the 6o lights per metre version would 
work well wrapped around a tree or installed 
on some other furniture. You may also consider 
getting RGBW LEDs for a brighter (and easier to 
program) white light effect if you desire. 


Install the software 

For the voice control and NeoPixels, we need 
to install a few extra Python libraries to Raspbian. 
First, install SpeechRecognition by opening the 
Terminal and typing: 


sudo pip3 install SpeechRecognition 
Then we need to install PyAudio and a FLAC 


encoder so that Raspberry Pi can hear what you’re 
saying and record it. Do it with: 
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sudo pip3 install pyaudio 
sudo apt install flac 


Plug a microphone in, and make sure that Raspbian 
is using it as an input device (you may need to 
right-click on the volume icon in the top right to 
do so). Then run the test script: 


python3 -m speech_recognition 
It will ask you to speak a word and it should return 
what you said. 


Finally, install the NeoPixel libraries with: 


sudo pip3 install rpi_ws281x 
adafruit-circuitpython-neopixel 


Build the circuit 

Build the circuit using the Fritzing diagram 
as a guide (Figure 1, overleaf). A Raspberry Pi can 
only power a handful of NeoPixel LEDs safely at 
a time, which is why you need an external power 
supply to power the LED strip. Four rechargeable 
AA batteries will get you the roughly 5 V you need. 
However, if you have a spare 5 V power supply anda 
jack to use, that will work just as well, if not better. 

The button is installed so we can activate the 

voice commands ~ it’s much easier than adding a 
trigger word like on a home voice assistant. 


Test your lights 

Once the circuit is all wired up, test your 
NeoPixels using the neopixel_rpi_simpletest.py 
script (if you can’t find it on your Raspberry Pi, 
head here: magpi.cc/Pci4iN). 


Program your own 
custom light patterns 
on your Christmas tree 


Make sure to test your setup while you're building, so you 
can discover any issues early on 


Change the number of NeoPixels to your 
requirements and run the script. If the colours 
seem off, you may need to change the ORDER = 
line from neopixel.GRB to neopixel.RGB — or 
neopixel.GRBW Or neopixel.RGBW if you have an 
RGBW strip of NeoPixels. 

This is also a good chance to make sure your 
circuit is properly wired up — check the grounds, 
the specific GPIO pins used, and whether or not it’s 
powered properly. 


A Raspberry Pi can only 
power a handful of 
NeoPixel LEDs safely 

at a time 


Tweak the code 

Download or type out the code listing for 
this tutorial - smartlights.py. This code was 
specifically tailored to our build, so you may need 
to make some changes to the code: specifically, the 
number of NeoPixels in your circuits, the type of 
NeoPixels (RGB/GRB/RGBW/GRBW), and the GPIO 
pins you’re using for the lights and button if you 
modified our circuit. 

Save the file, open up the Terminal, and enter: 


sudo nano /etc/profile 
Add this line to the end of the file: 
sudo python3 /home/pi/smartlights.py && 


This will start the script automatically whenever 
you turn on your Raspberry Pi. 


MéigPi 


Change the lights 
with your voice at 
the press of a button 


Smart Christmas tree lights 
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Speech 
recognition 
troubleshooting 


If you're having 
trouble with 

the test for the 
SpeechRecognition 
library, head here 
to troubleshoot: 
magpi.cc/RgpLyc. 


TopTip & 


RGBW code 


With RGB 
NeoPixels, you 
only need to 
program three 
variables: red, 
green, and blue. 
With RGBW ones, 
you'll need to 
add a fourth, e.g. 
(255,0,255,255). 


Explaining speech recognition 

The speech recognition part of the code is 
remarkably simple, and is mostly handled by the 
speech recognition library. It’s imported as sr in the 
script, and we use it to listen in on the microphone 
when required. Once a phrase has been said, it 
sends an audio file to Google Speech Recognition to 
be analysed, which is the value variable in our code. 

We use this value variable to check against 

our if statements — you’ll notice we haven’t 
capitalised ‘lights on’ or ‘lights off’, but we have 
done for ‘Merry Christmas’ as it returns the value 
in that way. If you plan to add more phrases, you 
may need to experiment with them. 


07 Adding trigger phrases 

We’ve tried to keep this very simple, 
including trigger words as part of if statements. 
To add one, all you need to do is add an extra if 
statement to the loop. Say you want to add the 
term ‘happy holidays’, you’d do so like this: 


if value == ‘happy holidays': 
strip. fi11((255,0,@) 


strip.show() 


In this example, we make the lights turn bright red. 
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Figure 1 The circuit is fairly 
simple - make sure you 
connect the DIN side of the 
NeoPixels to your Raspberry Pi 


Custom light patterns 

The basics of setting LED colours with 
NeoPixels involves telling the NeoPixels which red, 
green, and blue (RGB) values to use, from 0 (off) to 
255 (maximum). In the previous step, we set red/R 
to 255 for full red. You can make all three 255 for 
white. Check out this colour chart to find colour 
values: magpi.cc/Ey77xh. 

For more complex lights (alternating colours, 

rainbow effects, etc.) you’1l need to create 
a specific function that executes the effect. 
Some of these can be quite complicated, so we 
suggest checking the examples and docs for the 
NeoPixel library if you have an idea you'd like to 
try: magpi.cc/SQynFx. 


Install your lights 

Once you’ve perfected your lights and voice 
control, it’s time to put the lights up! We like to 
wrap ours around the tree, making sure there’s 
easy access to change any batteries. You may need 
to add some clips to the tree as well. 

If you plan to stick them to other furniture, 

you may need to make sure you have a temporary 
solution, like Velcro with sticky backs, so you can 
easily add and remove them at the start and end of 
the festive season. 


A We've seen people install lights in bookcases for fun effects 


Light up your tree! 

It’s time to do the final test of your lights 
and turn them on! Test out the voice control, and 
maybe think of moving the microphone position 
around. With some really long wires, you can also 
put the button to activate the speech recognition in 
a place that’s easy to reach. 

At the end of the day, you don’t have to turn the 
lights off, either: you just need to say ‘lights off’. 


™m The speech recognition 
part of the code is 
remarkably simple @ 


Adding sound and more 

One extra feature you might consider is 
sound output, which can be handled with Pygame. 
For some voice keywords, you could have lights 
sync up to classic Christmas songs, carols, or 
whatever you choose. 

We suggest making it so the song only plays 
through once before going back to normal, though, 
to avoid incurring the wrath of the people you live 
with. Last year we create a tree-topper star — you 
can easily add some NeoPixels to a 3D-printed star 
like this and have the system control it as well! 


Happy Holidays! 

We really hope you enjoy making this 
project and, even if you don’t celebrate Christmas, 
we hope you think of it as a great introduction to 
voice control with Python. 

From all of us at The MagPi, Happy Holidays anda 
Happy New Year! 


smartlights.py 


> Language: Python 
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DOWNLOAD 
THE FULL CODE: 


magpi.cc/SmartXmas 


ee1. 
ee2. 
003. 
004. 
005. 
006. 
007. 
008. 
ee9. 
e108. 
Q11. 
Q12. 
013. 
e14. 
Q15. 
016. 
Q17. 
018. 
Q19. 


020. 
@21. 
Q@22. 


23. 
024. 
@25. 
026. 
027. 
028. 
29. 
030. 
31. 
32. 
33. 
34. 
35. 
036. 
037. 
38. 
39. 
048. 
041. 
042. 
043. 
044. 
Q45. 
046. 
047. 
048. 
Q49. 
50. 
@51. 
Q@52. 
Q@53. 
Q54. 
@55. 
@56. 
Q57. 
@58. 
@59. 
060. 
061. 
062. 


import speech_recognition as sr 
import time 


from gpiozero import Button 


import board 
import neopixel 


button = Button(21) 
# speech recognition settings 


r = sr.Recognizer() 
m = sr.Microphone() 


# LED strip configuration: 

LED_COUNT = 90 # Number of LED pixels. 

LED_PIN = board.D18 # GPIO pin 

LED_BRIGHTNESS = 0.2 # LED brightness 

LED_ORDER = neopixel.GRB 

# order of LED colours. May also be GRB, GRBW, or RGBW 


# Create NeoPixel object with appropriate configuration. 
strip = neopixel.NeoPixel(LED_PIN, LED_COUNT, brightness = LED_ 
BRIGHTNESS, auto_write=False, pixel order = LED_ORDER) 


# Setting variables for a specific sequence 
red = (255,0,0) 

green = (0,255,0) 

flip = @ 


# Function to make an alternating series of lights 
def merrychristmas(): 


global flip 
for i in range(9@): 
if flip == @: 
strip[i] = red 
flip = 1 
else: 
strip[i] = green 
flip = @ 


strip. show() 


while True: 
button.wait_for_press() 
button.wait_for_release() 


# set the audio source 
with m as source: audio = r.listen(source) 


# recognize speech using Google Speech Recognition 
value = r.recognize_google(audio) 


# check the speech against trigger words 

if value == ‘lights on': 
strip.fill((255,255,255)) 
strip.show() 


if value == ‘lights off': 
strip.fill((@,0,2)) 
strip.show() 


if value == ‘Merry Christmas’: 
merrychristmas() 
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Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, 

and Raspberry 

Pi Projects 

for Dummies. 
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| You'll Need 


» Pimoroni LED SHIM 
magpi.cc/9962nm 


» Pimoroni 11x7 LED 
Matrix Breakout 
magpi.cc/JdMBNi 


» WS2812 LED strip, 
144 per metre 
magpi.cc/BfaifB 


» Figure 1 Three 
lengths of LED strip 
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Hack GraviTrax _ 
with Raspberry P1 


Make your GraviTrax layout trigger LEDs for a 
dazzling light show to enhance your layouts 


the balls as they passed by in a GraviTrax 
layout. We used this to trigger sound samples 
to accompany your ball’s run through your layout. 
This month we look at how to use those triggers 
to fire LED patterns. We are going to use both PC- 
controlled displays and the ubiquitous WS2812B 
LEDs, sometimes called NeoPixels. 


[ ast month we saw several ways of detecting 


What sort of LED? 

We will look at two sorts of LED here: the 
WS2812 and the I?C-controlled type, based on 
the 31FL3731 LED matrix driver. This last type has 
become more popular lately as it lends itself to 


controlling a lot of LEDs from a very small package. 


As the PC protocol is a bus, each 31FL3731 you 
have on a bus needs to have a different address. 
This chip is capable of being set to four different 
addresses, depending on what signal you connect 
to an external address line pin on the chip. There 
are techniques you can use with the PC bus to get 
more, but we won’t go into these here. 
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The WS2812B 

The WS2812B (aka NeoPixel) LED is available 
in anumber of different configurations, ranging 
from individual LEDs to arrays. We will concentrate 
here on just using the LED strips and LED rings. The 
aim is to make them fit into the GraviTrax system 
like an extension component, as we did with the 
detectors last month. For the strips, we used the 
highest LED density we could find at 144 LEDs per 
metre, although you could use others. Making a 
strip to run under a track is simple. We mounted 
a small section of LED strip on 13 mm wide, 3mm 
plywood. The length of track determines how many 
LEDs you can fit underneath them. 


LED strips 

For the three lengths of track used in the 
starter pack, we made 8-, 14-, and 20-LED strips. 
We glued a three-pin connector on the end and 
wired it up to the strip. Then we glued a cardboard 
hexagon to the middle of the strip, so the strip 
went across the flats of the hexagon. For the 8- 
and 20-LED strips, the hexagon was glued in the 
middle of the strip. But for the 14-LED strip, we 
glued the hexagon 10mm from one end because it 
only spans two hexagon positions — see Figure 1. 


LED rings 

There are two sizes of LED ring we found 
useful, the 12-LED ring and the 16-LED ring. 
We mounted the 16-LED ring horizontally on 
a 71mm round disc of 3mm plywood, and cut a 
6mm hexagonal hole in, to push-fit a large height 
tile into it. You can do this with a fret-saw if you 
haven’t got access to a laser cutter. If your cutting 
is not so accurate and the tile pushes through, 
you can always fix it with a dab of hot-melt glue. 


JOY _ggme~ 
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Timer display 


LED strip following 
the ball 


A Stargate 
LED ring 


A vertically mounted ring, where the ball runs 
through it, just has to be known as a Stargate. See 


al 
Figure 2 for the dimensions of the mounting for 
each type. S 
Horizontally mounted ring 60.00 


After cutting out the disc with a hexagonal 
hole in it, we used the existing holes in the ring 
to act as a marker. One hole at a time, we drilled 


through the holes in the ring with a 2mm drill. 71.00 
After each hole, we screwed the plate and ring r “| 
together with an M2 screw and nut so the assembly 

would not move while we did the next one. When Vertical ring mount Horizontal ring mount 

all the holes were drilled, we fixed the ring to the 
mount just using 5mm-long M2 screws and nuts to 


ra ™N for horizontal and 
act as a spacer. Note that this holds the ring firmly ¢ y f ‘N vertical rings 


Figure 2 Mountings 


in place without resorting to a nut on the other end 


j Figure 3 Detail of 
of the wood. See Figure 3. 


horizontal ring 


on 


The Stargate 

We used a 12-LED ring for this, mounted 
ona half plate. This time we used only two of 
the mounting holes to fix the ring on the plate, 
including nuts on the back of the board. We cut 
one cardboard hexagon in half across the points, 
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A Figure 4 Parts for the 
Stargate ring 


A Figure 5 The finished 
Stargate ring 


V_ Figure 6 Schematic 
of WS2812 
driver board 


5V 


ued this to another hexagon, and sandwiched 

the mounting plate between the two half hexagons 
— see Figures 4 and 5. The rings we got had the 

order of connections different to the strips: the 5V 
power was in the middle. To correct this, we made 
a 
u 


ice) 


crossover lead and, to be sure we didn’t mix them 
p with the others, we marked then with a blob of 
red paint in the middle. 


07 Driving the LEDs 

Normally when you use WS2812B LEDs, you 
chain them - that is, connect the data output from 
each strip to the data input on the next. While this 
works well most of the time, it doesn’t work here 
with the modular mix-and-match arrangement 
we would like. So we decided to only use the data 
input to a strip and use a bit of electronics to steer 
the data signal to one of eight outlets. We also need 
a bit of level shifting to boost the 3.3 V signal from 
Raspberry Pi to the 5V level the LEDs need. This 


Raspberry Pi 
GPIO connector 


circuit is shown in Figure 6. 
Figure 6 


WS2812b LED 
Strip Outputs 


GPIo 11 — 
{—_}— 3 
GPI09 — 
15 ro a 5 
GPIO 10 ——— 7 a = 2 
(—}-7 
GPIO 18 7 
270R 
Gnd 
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LED driver circuit 

The circuit works using a 74HCT4051 
analogue multiplexer to direct the data from GPIO18 
to one of the outputs. This signal is boosted to 5V 
first by passing it through two inverters — two so we 
don’t change the signal polarity. Each of the three 
select lines is also boosted to 5V and we cope with 
the signal inversion by simply relabelling the output 
pins. The circuit was made on a piece of stripboard 
37 holes long and 13 strips high, and the physical 
layout is shown in Figure 7, with the cut tracks on 
the back shown in Figure 8. 


Using 31FL3731 LEDs 

We used two types of 31FL3731 LED boards 
from Pimoroni: the colourful LED SHIM with 28 
tiny LEDs, and the 11*7 white matrix. They both 
use the [?C bus to communicate and, disturbingly, 
are at the same address of 0x75. However, the 
address of the matrix can be changed by cutting a 
link on the back marked ADDR-2 to change it to 
0x77, and a look at the data sheet shows that it can 
be set to two more addresses by connecting the top 
pad to either the ?C data pin (0x76) or to ground 
(0x74). Whit enables you to use three matrix 
boards with a SHIM, or four without. 


™ The SHIM is cleverly 
designed to be directly 
pushed over the 
GPIO pins 


LED SHIM 

The SHIM is cleverly designed to be directly 
pushed over the GPIO pins, so we had to modify it 
in order to use it with the GraviTrax system. First, 
we soldered a 4-pin header onto even pins 32 to 38 
- this was purely for mechanical support. Then we 
soldered another on the odd-numbered pins 1 to 7, 
and connected pin 1 to pad for pin 4 for the power, 
and pin 7 to the pad for pin 20 for the ground with 
thin wire. Then we cut a piece of 16mm by 69mm 
plywood and pushed the header pins into the wood. 
The small indentations were marked with pencil 
and 1mm holes drilled, so the SHIM pushed into 
the board. Painted black and glued onto a stack 
of two cardboard hexagons, the results are shown 
in Figures 9 and 10. 


11x7 matrix 

This is a white LED matrix and we can 
mount it in the GraviTrax system in two ways — 
horizontally or vertically. Horizontal mounting uses 
45mm by 24mm piece of 3mm plywood, mounted 
ona stack of three cardboard hexagons (Figure 11). 
Vertically uses a 25mm length of 32mm right-angle 
wood moulding on a single hexagon. We used a long 
header and pushed the pins to one end of the plastic 
strip to give us an even longer header length of 
9mm. By using M2.5 screws and 3mm nylon stand- 
off tubes, we mounted the matrix with the holes 
provided on it, as can be seen in Figure 12. 


LED animations 

The sorts of animations you can get the 
LEDs to do are almost limitless. The long LED 
strips can programmed so a single LED follows the 
path of the ball underneath it, with careful timing. 
Or a strip can be placed across the track so that the 
ball triggers an effect like it is breaking through a 
barrier. LED rings can be ‘kicked’ by a passing ball 
so an LED makes a complete circuit; or they can 
be made to flash when a dramatic event triggers, 
like the ball dropping to a lower level happens. 
Likewise, a matrix can show an animation or a 
number, like a time (Figure 13, overleaf). 


WS2812 software 

Most animations can be used with a large 
number of variation of colour, speed, and effects, 
so we need to have software that will allow 
animations to be called with a large number of 
variations. We have chosen to use threads to make 
this simpler. neo_thread.py shows what we came 
up with for the WS2812 strips. We appreciate that 
a thread can be timed out at any time and, if this 
happens between the setting of the strip address 
and the showing of that strip, the animations 
might be wrong. In practice this rarely happens 
and is not very noticeable when it does. 


31FL3731 software 

We separated this from the WS2812 software 
because it’s easer to leave out if you don’t have 
any of that sort of display, but it follows the same 
format as the other code (see FL3731_thread.py) 
You first need to install the libraries for the SHIM 


Figure 7 
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A Figure 7 Physical 


layout of WS2812 
driver board 


A Figure 8 Track cuts 


for the WS2812 
driver board 


4 Figure 9 Modifications 


to the LED shim 


Figure 10 Mounted 
LED SHIM 


Figure 11 Horizontally 
mounted matrix 


Figure 12 Vertically 
mounted matrix 
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in Me 
Figure 13 


and matrix from the Pimoroni website. Feel free 
to write your own animation functions to call 

if you want something else. The SHIM patterns 
can consist of a pre ball passage animation with 
another animation for when the ball passes. In the 
listing, this is triggered on thread 6. 


As a temporary measure, pattern_trigger.py is 
some simple code to trigger these effects from your 
keyboard for testing. 

Next month, in the final part, we will look 
at how to bring this all together in terms of 
the hardware interface to Raspberry Pi’s GPIO 
connector and having a single integrated 
software interface. 


neo_thread.py 


> Language: Python 
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#!/usr/bin/env python 
# Neopixel patterns from a thread 
# By Mike Cook November 2019 


import threading 
import time 

import board 

import neopixel 
import RPi.GPIO as io 


def startwWs2812Thread(number) : 
if number == 
# Thread Leds Dely Dir front back wipe 
ws2812_thread@ = threading. Thread(target = push, 
args = (number, 12, 0.5, True, 
(30, @, @), (@, 30, @), True)) 
wS2812_thread@.start() 
elif number == 
ws2812_thread1 = threading. Thread(target = push, 
args = (number, 12, 0.5, True, 
(30, @, @), (@, 30, @), True)) 
wS2812_thread1.start() 
elif number == 
ws2812_thread2 = threading. Thread(target = push, 
args = (number, 12, 0.5, False, 
(30, @, @), (@, 30, @), True)) 
ws2812_thread2.start() 
elif number == 
ws2812_thread3 = threading. Thread(target = push, 
args = (number,12,0.2, False, 
(30, @, @), (@, 30, @),True)) 
wS2812_thread3.start() 
elif number == 
ws2812_thread4 = threading. Thread(target 


seq, 


@35. 
Q36. 
Q37. 
638. 
@39. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
058. 
@51. 
Q52. 
@53. 
@54. 


@55. 
Q56. 
Q57. 
058. 
@59. 
060. 
061. 
062. 
063. 
064. 
Q65. 
066. 
067. 


args = (number,3, 0.06, False, 
(®, @, 30), (20, 20, 20), False)) 
ws2812_thread4.start() 
elif number == 
ws2812_threadS = threading. Thread(target = flash, 
args = (number,4,0.12, False, 
(®, 30, 30), (30, @, @), False)) 
ws2812_thread5.start() 
elif number == 
ws2812_thread6 = threading. Thread(target = run, 
args = (number, 14, 0.13, False, (30, 9, @), 
(®, @, @), False)) 
ws2812_thread6.start() 
elif number == 
ws2812_thread7 = threading. Thread(target=push, 
args = (number, 20, 0.03, False, 
(30, 30, ®@), (@, @, 30), False)) 
wS2812_thread7.start() 


def run(add, numLed, delay, direction, frontCol, 
backCol, wipe): 
strip[add] .fl1(backCol) 
for i in range(®, numLed): 
jedi 
if direction : j = numLed - i 
strip[add][j] = frontcol 
setAdd(add) ; strip[add].show() 
time.sleep(delay) 
if not wipe : strip[add].f11(backCol) 
setAdd(add) ; strip[add].show() 
time.sleep(delay) 
strip[add].fill((@, @, @)) # clear out 
setAdd(add) ; strip[add].show() 
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pattern_trigger.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


y) magpi.cc/Et6Qnt 


001. #!/usr/bin/env python 013. try: 
@02. # Testing Neopixel and FL3731 patterns from a thread 14. while 1: 
Q@3. # By Mike Cook November 2019 @15. thread = int(input("Thread to trigger “)) 
004. 016. if thread >=@ and thread <=7 : 
@@5. import neo_thread as ws @17. ws. StartWs2812Thread(thread) 
006. import FL3731_thread as fl e18. if thread >=12 and thread <= 16 : 
007. 19. #1.startFL3731Thread(thread - 10) 
@08. ws.initIO() 20. if thread == 100 : 
@e9. f1.initI2C() 21. #1.stopCount() 
@10. print("To quit just type return") @22. #1.stopAnimations() 
@11. print("To trigger FL3731 threads add 10 to the number @23. except : 
you type") @24. 1. stopCount() 
@12. print("To stop animations and counts type 100") @25. f1.stopAnimations() 
@68. def flash(add, repeats, delay, direction, frontCol, e99 for j in range(®, repeats): 
backCol, wipe): 100 strip[add] .f11(backCol) 
69. strip[add].fil1(backCol) 101. for i in range(®, len(seqToLight)): 
70. for i in range(®, repeats): 102. for k in range(@, len(seqToLight[i])) : 
71. strip[add].fill(frontCol) 103. strip[add][seqfoLight[i][k]] = frontCol 
072. setAdd(add) ; strip[add].show() 104. setAdd(add) ; strip[add].show() 
073. time.sleep(delay) 105. time.sleep(delay) 
e74. strip[add] .fl1(backCol) 106. if not wipe : 
@75. setAdd(add) ; strip[add].show() 107. for k in range(®, len(seqToLight[i])) : 
76. time.sleep(delay) 108. strip[add][seqToLight[i][k]] = backCol 
077. if not wipe : 109. setAdd(add) ; strip[add].show() 
078. strip[add].f11((@, ®, @)) 110. 
79. setAdd(add) ; strip[add].show() 111. def initI0(): 
e8e. 112 global muxAdd, strip 
@81. def push(add, numLed, delay, direction, frontCol, 113 io.setwarnings(False) 
backCol, wipe): 114 io.setmode(io.BCM) 
82. strip[add].f11(backCol) 115 muxAdd = [11, 9, 10] 
083. k = numLed // 2 116 io.setup(muxAdd, io.OUT), # set pins as outputs 
084. for i in range(numLed // 2, numLed): 137 pixel_pin = board.D18 
e85. jz=i;k-=1 118 num_pixels = 2@ # maximum LEDs in biggest strip 
86. strip[add][j] = frontCol 119 ORDER = [neopixel.GRB] * 8 
087. strip[add][k] = frontCol 120 strip = [] 
88. setAdd(add) ; strip[add].show() 121 for i in range(@, 8): 
89. time.sleep(delay) 122 pixels = neopixel.NeoPixel( 
e908. if not wipe : 123. pixel_pin, num_pixels, brightness = @.1, 
91. strip[add][j] = backCol 124. auto_write = False, pixel_order = 
92. strip[add][k] = backCol ORDER[i]) 
93. setAdd(add) ; strip[add].show() 125, strip. append(pixels) 
Q94. 126. 
@95. def seq(add, repeats, delay, direction, frontCol, 127. def setAdd(add): 
backCol, wipe): 128. for i in range(®, 3) : io.output(muxAdd[i], 9) 
96. seqroLight = ( [3], [2, 4], [1, 5], [0 6], 129. if add & 1 : io.output(muxAdd[@], 1) 
097. (11, 7], [10, 8], [9], [10, 8], [11, 7], 130. if add & 2 : io.output(muxAdd[1], 1) 
e98. (0, 6], [1, 5], [2, 4], [3]) 131. if add & 4 : io.output(muxAdd[2], 1) 
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FL3731_thread.py 


» Language: Python 


001. 
ee2. 
003. 
004. 
005. 
006. 
007. 
008. 
09. 
010. 
011. 
12. 
013. 
014. 
15. 
16. 
017. 
018. 
19. 
20. 


21. 
Q22. 
023. 
024. 
25. 
26. 
027. 
028. 
@29. 
030. 
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Q33. 
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043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
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#!/usr/bin/env python 


FL3731 patterns from a thread 

By Mike Cook November 2019 

With some functions from Pimoroni examples 
See Pimoroni site for how to install 

the matrix11x7 and ledshim libiaries 


import threading 
import time 
from matrix11x7 import Matrix11x7 
from matrix11x7.fonts import font5x7 
import random 
import colorsys 
from sys import exit 
import ledshim 
try: 
import numpy as np 
except ImportError: 
exit('This script requires the numpy module\ 
nInstall with: sudo pip install numpy') 
ledshim.set_clear_on_exit() 


def startFL3731Thread(number): 
if number == 
matrix_thread@ = threading. Thread(target = 
spinC, args = (2, 0.008, 0.1, @.@1)) 
matrix_thread@.start() 
elif number == 
matrix_thread1 = threading. Thread(target = 
spinA, args = (2, 0.008, @.1, @.01)) 
matrix_thread1.start() 
elif number == 
matrix_thread2 = threading. Thread(target = 
timer, args = (2, 1.0)) 
matrix_thread2.start() 
elif number == 
matrix_thread3 = threading.Thread(target = 
solid, args = ()) 
matrix_thread3.start() 
elif number == 
matrix_thread4 = threading. Thread(target = 
pulse, args = ()) 
matrix_thread4.start() 
elif number == 
matrix_thread5 = threading. Thread(target = 
larson, args = ()) 
matrix_thread5.start() 
elif number == 6: # after shim background animate 
matrix_thread6 = threading. Thread(target = 
breakup, args = ()) 
matrix_thread6.start() 


def stopCount(): 
global stopTimer 


stopTimer = True 


def stopAnimations(): 


def 


def 


def 


def 


global animateStop 
animateStop = True 


InNitT2€(): 
global matrixInstance 
stopCount() 
stopAnimations() 
matrixInstance = [] 
for i in range(@,4): 
iry 
ins = Matrix11x7(i2c_address = i + @x74) 
except : 
print("nothing", i, "at address", 
hex(i+ @x74)) 
ins = 0 
matrixInstance. append(ins) 


spinC(device, speed, stopSpeed, retard):# clockwise 
pattern = 0 
while speed < stopSpeed: 
draw(pattern, device) 
pattern += 1 
if pattern > 3: 
pattern = @ 
speed += retard 
time.sleep(speed) 


spinA(device, speed, stopSpeed, retard): 
pattern = 3 
while speed <= stopSpeed: 
draw(pattern, device) 
pattern -= 1 
if pattern < @: 
pattern = 3 
speed += retard 
time.sleep(speed) 
draw(3,device) 
timer(device, speed): # show time 
global stopTimer 
stopTimer = False 
matrixInstance[device].set_brightness(@.5) 
matrixInstance[device].clear() 
startT = time.time() 
while not stopTimer : 
display = str( (int(time.time()-startT) * 10) 
// 10 ) 
matrixInstance[device].write_string(display, 
x=0, y=@, font=font5x7) 
if len(display) == 1: 
matrixInstance[device].scroll(-3) 
if display == "1": 
matrixInstance[device].scroll(-1) 
else : 
if display[0] == "1": 
matrixInstance[device].scroll(-1) 
matrixInstance[device].show() 
matrixInstance[device].clear() 
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def 


def 


def 


def 


def 


time.sleep(1.0) 
if int(display) > 98 : stopTimer = True 
matrixInstance[device].set_brightness(1.@) 


wipeL(device, speed): 
for x in range(@,12): 
matrixInstance[device].clear() 
for y in range(@,7): 
matrixInstance[device].set_pixel(x,y,@.5) 
matrixInstance[device] .show() 
time.sleep(speed) 


# wipe left 


wipeR(device, speed): # wipe right 
for x in range(11,-1,-1): 
matrixInstance[device].clear() 
for y in range(@,7): 
matrixInstance[device].set_pixel(x,y,@.5) 
matrixInstance[device] .show() 
time.sleep(speed) 
matrixInstance[device].clear() 
matrixInstance[device] .show() 


larson(): 
global animateStop 
animateStop = False 
REDS = [@] * 56 
SCAN = [1, 2, 4, 8, 16, 32, 64, 128, 255] 
REDS[28 - len(SCAN):28 
+ len(SCAN)] = SCAN + SCAN[::-1] 
start_time = time.time() 
while not animateStop: 
delta = (time.time() - start_time) * 56 
offset = int(abs((delta % len(REDS)) - 28)) 
for i in range(@, 28): 
ledshim.set_pixel(i, REDS[offset + i], 
@, @) 
ledshim.show() 
time.sleep(@.05) 


solid(): 

global animateStop 

animateStop = False ; step = 0 
while not animateStop : 


if step == @ : ledshim.set_al1(128, 0, @) 
if step == 1 : ledshim.set_all(@, 128, @) 
if step == 2 : ledshim.set_all(@, 0, 128) 


step t= 1 ; step %= 3 
ledshim.show() ; time.sleep(@.5) 


pulse(): 
global animateStop 
animateStop = False 
while not animateStop: 
for z in list(range(1, 10)[::-1]) + list( 
range(1, 10)): 
fwhm = 15.0 / z 
gauss = make _gaussian(fwhm) 
y = 435 start = time.time() 


def 


def 


def 


for x in range(ledshim.NUM_PIXELS): 
h=0.5 5; s=1.0 5 v = gauss[x, y] 
rgb = colorsys.hsv_to_rgb(h, s, v) 
r, g, b = [int(255.0 * i) for i in rgb] 
ledshim.set_pixel(x, r, g, b) 
ledshim. show() 
end = time.time() 
t = end - start 
if t < 0.04: 
time.sleep(@.04 - t) 


breakup(): 
stopAnimations() # stop animation thread 
showTime = 2.@ # show for 2 seconds 
startTime = time.time() 
while time.time() - startTime < showTime : 
pixels = random. sample( 
range(ledshim.NUM_PIXELS), 
random.randint(1, 5)) 
for i in range(ledshim.NUM_PIXELS) : 
if i in pixels: 
ledshim.set_pixel(i, 255, 150, 0) 
else: 
ledshim.set_pixel(i, @, @, @) 
ledshim.show() ; time.sleep(@.@5) 
ledshim.clear() # turn off after showTime 
ledshim. show() 


draw(n,ins): 
matrixInstance[ins].clear() 
if n == 
y= 
for x in range(2, 9): 
matrixInstance[ins].set_pixel(x, y, 9.5) 
y +=1 
elif n == 


for y in range(@,7): 
matrixInstance[ins].set_pixel(x, y, 9.5) 
elif n == 


for x in range(2, 9): 
matrixInstance[ins].set_pixel(x, y, 9.5) 


y=3 
for x in range(1, 10): 
matrixInstance[ins].set_pixel(x, y, 9.5) 
matrixInstance[ins].show() 


make_gaussian(fwhm) : 

xX = np.arange(@, ledshim.NUM PIXELS, 1, float) 

y = x[:, np.newaxis] 

x®, yO = 3.5, (ledshim.NUM PIXELS / 2) - 0.5 
fwhm = fwhm 

gauss = np.exp(-4 * np.log(2) * ((x - x@) ** 2 + 


(y - ye) ** 2) / fwhm ** 2) 


return gauss 
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Set up a Raspberry P1 
retro games console 


Lakka lets you relive the games of the past by enabling your 
Raspberry Pi to emulate a host of retro computers and consoles 


Lucy 
Hattersley 


Lucy is editor of The 
MagPi magazine. 
She enjoys retro 
gaming; especially 
making retro games. 


magpi.cc 


[ You'll Need 


Raspberry Pi 4 


v 


USB or wireless 
game controller, 
e.g. magpi.cc/ 
vilrosgamepad 


Vv 


Windows PC or 
Mac computer 
for setup 


Vv 


Blank microSD card 
(8GB or larger) 


Vv 


SD Formatter 
magpi.cc/ 
sdcardformatter 


Vv 


Vv 


NOOBS image file 
magpi.cc/downloads 


» Agame ROM, e.g. 
magpi.cc/bladebuster 


hether you are nostalgic for the games 
W of yesteryear or you’re simply dying 

to discover gaming’s rich history, all 
you ultimately need to get stuck in is a bunch of 
emulators and a stack of gaming ROMs. 

In the past, however, this has also entailed 
finding and downloading the BlOSes of various 
machines and a fair bit of configuration. 
Fortunately, with the software platform Lakka 
installed on your Raspberry Pi 4, the path to 
gaming glory is much smoother these days. 

Lakka allows you to emulate arcade games as 
well as titles originally released on a host of 8-bit, 
16-bit, and even 32- and 64-bit systems. 

Lakka is a Linux operating system (OS) based 
on RetroArch (retroarch.com). Lakka is designed 
to run games, and it turns a Raspberry Piintoa 
powerful games system. 

You can hook up a gamepad and even make use 
of wireless controllers (there’s more about those 
at magpi.cc/HpPSSV). It has an interface that will 
be very familiar to anyone who has used modern 
games consoles and because it is open-source, it 
is constantly being improved. 

You can run Lakka on any Raspberry Pi, 
although Raspberry Pi 4 enables smoother 
emulation of more recent consoles. 


A NOOBS (New Out Of Box Software) is used to install 
operating systems such as Lakka on Raspberry Pi 
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Some features help you organise your growing 
gaming collection and take screenshots of the 
in-game action. For now, though, we’re looking 
solely at getting you up and running with a classic 
homebrew video game. 


Get SD Card Formatter 
We’re going to install Lakka RPI4 to 
a blank microSD card using the OS installer 
NOOBS (magpi.cc/noobs). 
In this tutorial, we’re using a Windows PC 
to format a microSD card and copy the NOOBS 
files to the card (the process is identical for Mac 
computers). We will then use the NOOBS card 
with our Raspberry Pi 4 and set up Lakka. From 
then on, our Raspberry Pi 4 will boot straight to 
Lakka and let us run games. 
First, download SD Formatter on a computer from 
magpi.cc/sdcardformatter. Click ‘For Windows’ or 
‘For Mac’ depending on your machine. 


Format the card 

We’re now going to format the microSD card 
that you will use to boot Lakka on a Raspberry Pi. 
Note that this completely wipes the card, so make 
sure it contains nothing you need. 

Insert the microSD card into your Windows 
or Mac computer. You will need to use either 
a USB SD card adapter or microSD card to SD 
card adapter. 

Close any alert windows that appear, and open 
the SD Card Formatter app. Accept the terms and 
conditions and launch the program. On a Windows 
PC, click Yes to ‘Do you want to allow this app to 
make changes to your device’ (you won’t see this 
ona Mac; the approval comes later). 
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Main Menu 


Load Core 


Select which core to use. 


Load Content 


The Settings menu has options 
to connect to a wireless 
network, turn on Samba file 
sharing, and set up a gamepad 


Online Updater 


Cores are the emulators 
used to run retro games. 
They are modular 
components based on 
classic systems and games 


Reboot 


Shutdown 


The card should be assigned a letter under Select 
Card. It is ‘D’ on our system. Check the Capacity 
and other details to ensure you have the correct 
card. Now click Format and Yes. On a Mac, you’1l be 
asked to enter your Admin password. 


Download NOOBS 
Now visit magpi.cc/downloads and click the 
NOOBS icon. Select ‘Download ZIP’ next to NOOBS. 

The latest version of the NOOBS zip file 
(currently NOOBS_v3_2_1.zip) will be saved to 
your Downloads folder. 

Extract the files from the NOOBS zip file (right- 
click and choose Extract All and Extract). Now 
open the extracted NOOBS folder (it’s important 
to ensure you are using the extracted files and not 
looking at the files inside the zip file. Make sure 
you have opened the NOOBS_v3_2_1 folder and 
not the NOOBS_v3_2_1.zip file. 

You should see three folders — defaults, os, and 
overlays — followed by many files beginning with 
“bem2708...’. It is these folders or files you need to 
copy to the microSD card. 

Select all of the files inside the NOOBS folder 
and copy them to the microSD card. When the files 
have copied, eject and remove the microSD card 
from your PC or Mac. 


Information 


Restart RetroArch 


Boot to NOOBS 
Now set up your Raspberry Pi 4. You’ ll 
need to connect a USB keyboard and HDMI display 
for the installation process (you can remove the 
keyboard later and use just a game controller). 
The display does not have to be the television 
you intend to use. It’s best to use Raspberry Pi 4’s 
HDMI 0 port. We’re going to use a wireless LAN 
network to connect to the internet, but you can 
connect an Ethernet cable attached directly to 
your modem/router. 
Insert the microSD card into your Raspberry Pi 
and attach the USB-C power supply to power up. 


M To get further installation options on 
the NOOBS screen, you will need to be 
connected to the internet 


Connect to wireless LAN 

The NOOBS screen will appear, displaying 
two installation options: Raspbian Full and 
LibreELEC. To get further installation options, you 
will need to be connected to the internet. 

Connect Raspberry Pi directly to your modem/ 
router using an Ethernet cable; or click the ‘Wifi 
networks (w)’ icon. The WiFi network selection 
window appears; wait until it displays the local 
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A Blade Buster, a 
homebrew shoot- 
‘em-up, running ona 
Raspberry Pi 4 


Warning! 


Itis illegal to download 
copyrighted game ROMs 
from the internet. Please 
respect the original maker 

and seek a legal source 
for retro gaming instead. 
We use homebrew ROMs 
made by modern makers 

for classic systems. 


magpi.cc/legalroms 


TopTip & 
SSH 


You can also 

use SSH to copy 
files from your 
computer to 
Raspberry Pi. In 
Lakka, enable SSH 
in Services. You 
can use a program 
such as FileZilla to 
copy files across. 
See magpi.cc/ssh 
for more 
information. 


networks. Select your wireless network and enter 
the password for it in the Password field. Then 
click OK. 

With Raspberry Pi connected to a network, you 
get a much broader range of installation options. 
Near the bottom will be Lakka_RPi4. 

Use the arrow keys on your keyboard to select 
Lakka and press the SPACE bar to add a cross to its 
selection box (or use a connected mouse to select 
the Lakka option). 

Click Install and answer Yes to the Confirm 
window. NOOBS will download and extract the 
Lakka file system to the microSD card. Sit back and 
wait for the system to be installed. 

When it has finished, NOOBS will display ‘OS(es) 
Installed Successfully’. Press ENTER on the 
keyboard (or click OK with the mouse). 


Starting Lakka 


Raspberry Pi will restart and this time it will 
boot into the Lakka operating system. You will see 
a blue screen with a series of windows and ‘Load 
Core’ will be highlighted. You can use the arrow 
keys on the keyboard to navigate the menu, and X 
to select a menu option, then Z to back up. 

Highlight Load Core and press X to select it. Here 
you will find a list of ‘cores’. These are the engines 
that emulate different retro consoles and computers. 

To test the system is working, highlight 2048 and 
press X again. You’1l be returned to the main menu, 
but this time you’ll see ‘Start Core’. Press X to start 
the core and you’ll be presented with a classic game 
called 2048. Use the arrow keys to slide the blocks 
together. Matching numbers double in size, and 
the aim is to make a 2048 block. Press ESC and ESC 
again to return to the main Lakka menu. 
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07 Connect to the network 

You need to connect Lakka to the network. 
Use your cursor keys to navigate Lakka’s menus, 
and head to the Settings list. Press the down 
arrow and select ‘Wi-Fi’. Wait for Lakka to scan 
the local networks. 

Select your wireless LAN network and use the 
keyboard to enter the Passphrase. The Lakka 
interface will display the name of your wireless 
network with ‘Online’ next to it. 


Get a game 

Now it’s time to find and play a game. 
Games are downloaded as ROM files and added to 
Lakka. These ROM files need a compatible core to 
run (most but not all ROM files will run correctly). 

We’ll use a Japanese homebrew ROM called 
Blade Buster. Download it on your PC or Mac from 
magpi.cc/bladebuster — click the ‘Blade Buster 
Download’ link. 

A file called BB_20120301.zip will appear in 
your Downloads folder. Unlike NOOBS, you do not 
extract the contents of this file - ROMs are run as 
compressed zip files. You now need to transfer this 
file from your computer to your Raspberry Pi. 


Turn on Samba 

With your Raspberry Pi and PC on the same 
network, go to the Settings menu in Lakka on your 
Raspberry Pi and select Services. Highlight Samba 
and turn it on by pressing X (or using right arrow). 

Samba is installed by default on macOS and used 
to be installed by default in Windows, but it has 
recently become an optional installation. 

In Windows 10, click on the Search bar and type 
‘Control Panel’. Click on Control Panel in the 
search results. Now click ‘Programs’ and ‘Turn 
Windows features on or off’. Scroll down to find 
‘SMB 1.0/CIFS File Sharing Support’ and click the 
‘+? expand icon to reveal its options. Place a check 
in the box marked ‘SMB 1.0/CIFS Client’. Click 
OK. This will enable Samba client support on your 
Windows 10 PC so it can access Raspberry Pi. 


Transfer the ROM 

Lakka may appear in the left-hand column 
of your other computer’s file browser (File Explorer 
on a PC or Finder on a Mac). 


If not, select Lakka’s main menu on your 
Raspberry Pi, then choose Information and 
Network Information. 

Take note of the IP address. Enter that into the 
File Explorer using the format: 

\\insert.full.ip.address\ 


Ours, for example, is: 
\\192.168.0.13\ 


Copy the Blade Buster zipped game to the ROMS 
folder on Lakka. 

Back on your Raspberry Pi, go to Load Content 
> Start Directory in the Lakka menu and find the 
BB_20120301.zip file. Click it before selecting 
Load Archive. Choose FCEUmm as the core to 
play it on. 

Press ENTER to start the game. Use the arrow keys 
to move and X to fire. Enjoy playing the game. Press 
ESC twice when you’re done, to return to Lakka. 


Set up a controller 

Video game consoles rarely come with 
keyboards. And no doubt you’!l want to attacha 
controller to your console. 

If using a wireless gamepad, insert its dongle 
into one of Raspberry Pi’s USB ports, insert the 
batteries, and turn it on. Press the Start button on 
the gamepad and it will light up. 

Use the arrow keys to choose Input and User 
1 Binds. If it is connected correctly, you will see 
‘RetroPad’ next to User 1 Device Type. Scroll down 
and choose User 1 Bind All. Follow the on-screen 


instructions to press the buttons and move the 
analogue sticks on the gamepad. You may have to 
go through it a few times to get the process right. 

You can also set each button individually using 
the options. Once everything is set up correctly, 
you’ ll be able to use the gamepad to control your 
Raspberry Pi console. 


Move to the television 

Your Raspberry Pi games console is now 
ready to be moved to your television. You will be 
able to control the games console using your USB 
or wireless controller and move ROM files directly 
to it from your Windows PC or Mac computer. 
There’s a lot more to Lakka to discover, but for now 
we hope you enjoy playing retro games on your 
Raspberry Pi console. 


Set up a Raspberry Pi retro games console 


MéigPi 


Top Tip 


Ask for help 


It's worth heading 
over the Lakka 
forums for friendly 
help and advice: 
magpi.cc/ 
lakkaforum 


Match the buttons 
and sticks ona 
gamepad to the 
controls used in 
each core 
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Dialogs 
with C and GTK 


Give users information and ask them questions using didlogs, 
including some ready-made ones for frequently used functions 


void open_dialog (GtkWidget *wid, 
gpointer ptr) 


inform them of something, the best way to do 

this is with a dialog box. GIK makes it easy to { 
create dialogs — a GtkDialog can contain any GIK 
widgets, so can be as simple or as complex as 
you need. 
The characteristic which distinguishes a dialog 
from a window in GTK is that a dialog interrupts 
the operation of the application — once a dialog is 
shown, the rest of the application waits until the 
Pi Desktop on dialog is closed. int result = gtk_dialog run ( 
peace Dialogs all have one or more buttons (typically GTK_DIALOG (dlg)); 
and Debian. = 

with functions like ‘OK’ and ‘Cancel’) in what is gtk_widget_destroy (dlg); 

called the action area at the bottom of the dialog; printf ("Return code = %d\n, result"); 


[ f we want to ask the user a question, or to 


Simon 


4 : i 
Long GtkWidget *dlg 


gtk_dialog new_with_buttons ( 
"My dialog", GTK_WINDOW (ptr), 
GTK_DIALOG MODAL | 
GTK_DIALOG_DESTROY_WITH_PARENT, 
"Cancel", @, "OK", 1, NULL); 


Simon Long 

is a software 
engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry 


rpf.io 


these close the dialog and return control to the main 
window. Each button in the action area generates a 
different return code, which is passed back from the 
dialog to give the user’s response. 

Here’s the code for a simple dialog — connect 

this to the clicked signal on a button with 
g_signal_connect, and pass a pointer to the main 
window of your application as the general-purpose 
pointer in the g_signal_connect function: 


= 


An Introduction 
toC & GUI | 
Programming 


INTRODUCTION 


CsaGUI 


For further tutorials on how to start coding 


in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 
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The gtk_dialog new_with_buttons function takes 
a number of arguments. The first is the text to be 
displayed on the title bar of the dialog. The second 
is a pointer to the main window of the application 
- this is why a pointer to the main window 

should be supplied to the g_signal_connect 
function which links this handler to a button’s 
clicked signal. 

The third argument is a set of flags which control 
the behaviour of the dialog; in this case we set it to 
be a modal dialog and set it to be destroyed along 
with its parent window. Making a dialog modal 
means that the parent window will be locked 


Figure 1 


A Figure 1A simple GtkDialog, with two buttons in the action area 


while the dialog is on display — it forces the user to 
close the dialog before they can continue, which is 
usually the desired behaviour. Making the dialog be 
destroyed along with its parent is just for tidiness — 
it means that if the main window of the application 
closes for some reason while the dialog is on 
display, then the dialog will also close. (It is quite 
rare to create a dialog without setting it to be modal 
and destroyed with its parent.) 
The remaining arguments control which 
buttons are displayed in the action area of the 
dialog. This is a list of paired values; the first of 
e 

a 


ach pair is the label to be displayed on a button, 
nd the second is the return code which that 
button will generate when clicked. The list is 
terminated with a NULL value. 

Once we have created our dialog, we call 
gtk_dialog_run — this displays the dialog and 
allows the user to interact with it. They will be 
able to operate any widgets on the dialog, but the 
main window will be locked while they do so, and 
execution of code waits inside the gtk_dialog_run 
function until a button in the action area is clicked. 
At this point, you need to call gtk_widget_destroy 
on the dialog to get rid of it - you might have 
expected clicking a button to remove the dialog, but 
this doesn’t happen; the dialog stays on screen until 
it is explicitly removed. 


M You might have expected 
clicking a button to 
remove the dialog, but this 
doesn't happen 


Build and run the code — when you click the 
button which calls this handler, the dialog should 
be displayed (Figure 1). 

While the dialog is on screen, clicking any other 
controls on the main window will have no effect. 
When you close the dialog by clicking either the 
‘OK’ or ‘Cancel’ buttons, you will see a message 
showing the return code for the button you clicked 
in the terminal window from which you launched 
the application. 

That’s a basic dialog, but it’s a bit small and bare! 
Let’s add a label to it to ask the user a question. To 
do this, we have to access the dialog’s content area 
- effectively, a dialog is a GtkWindow which holds 
a GtkVBox with two GtkContainers in it — one is the 
action area at the bottom which holds the buttons, 
and the other is the content area at the top. We add 
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Figure 2 


OK 


A Figure 2 A GtkDialog 
with a label added to 
the content area 


any additional content to the dialog in the content 
area, which can be accessed using the function 
gtk_dialog_get_content_area. Modify the handler 
above like this: 


void open_dialog (GtkWidget *wid, 
gpointer ptr) 


{ 
GtkWidget *dlg = 
gtk_dialog new_with_buttons ( 
“My dialog", GTK_WINDOW (ptr), 
GTK_DIALOG_MODAL | 
GTK_DIALOG_DESTROY_WITH_PARENT , 
EGancelly,) Os) sOKan te NULL) 


int result = gtk_dialog run ( 
GTK_DIALOG (dlg)); 
gtk_widget_destroy (dlg); 
printf ("Return code = %d\n", result); 
} 


We’ve used the familiar gtk_container_add function 
to add our label to the content area of the dialog. 
Note that we also needed to call gtk_widget_show on 
the label we added - gtk_dialog_run automatically 
shows the widgets which are a part of the dialog 
itself, like the background and the buttons, but 
you need to explicitly show everything else you 
add (Figure 2). 
As with the main application window, if we want 
to add more than one widget to the content area, we 
first need to add a box ora table, and then to put the 
widgets into that. 
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WV Figure 4 The dialog 
opened from a 
GtkFileChooserButton 
to select an 
existing file 


7 < Bpi gtk 
2 Search C3 gtkeb 
@Recently Used 
@ pi & gtko 
WW Desktop ff gtktest 
O File System 


Built-in dialogs 

There are some common dialog boxes which are 
used in many desktop applications; for example, for 
choosing a file name to load or save, or for selecting 
a colour. GTK includes ready-made versions of these 
common dialog boxes which can easily be included 
in an application without needing to create every 
aspect of the dialog from scratch. 

For most of these dialogs, there is a GIK button 
which launches the dialog; the easiest way to 
include the dialog is to include the appropriate 
button in your application, and everything is then 
done for you. 


File chooser dialogs 

Let’s look at an example of a file chooser dialog, 
used to get the name and path of a file which can 
then be used in a subsequent file read operation. 


void main (int argc, char *argv[]) 


il 
gtk_init (&argc, &argv); 


Figure 4 


17/09/18 


112 bytes 01/10/18 
5.6kB 1401 
147kB 140) 
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(None) 


Ptteeeeeeeey 


Close window. 


A Figure 3 A GtkFileChooserButton 


GtkWidget *win = gtk_window_new ( 
GTK_WINDOW_TOPLEVEL) ; 

GtkWidget *btn = 
gtk_button_new_with_label ( 
"Close window") ; 

g_signal_connect (btn, "clicked", 
G_CALLBACK (end_program), NULL); 

g_signal_connect (win, "delete_event", 
G_CALLBACK (end_program), NULL) ; 


GtkWidget *vbox = gtk_vbox_new (FALSE, 5); 
gtk_container_add (GTK_CONTAINER (win), 
vbox) ; 


gtk_box_pack_start (GTK_BOX (vbox), btn, 
TRUE, TRUE, @); 
gtk_widget_show_all (win); 
gtk_main (); 
} 


A widget of type GtkFileChooserButton is 
created, and added to the window. The 
gtk_file_chooser_button_new function takes two 
arguments; the first is the title to apply to the 
file chooser window when it is opened, and the 
second determines what the file chooser window 
will do. In this case, we want to open an existing 
file, so GTK_FILE_CHOOSER_ACTION_OPEN is 

used. (The alternative is to select an existing 


folder, for which the argument would be 
GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER. ) 

The file-set signal is connected to the 
button — this is called when the user makes a 
selection — and in the handler for that signal, the 
gtk_file_chooser_get_filename function is called to 
read back the name of the file selected. 

When this code is run, you will see a window 
which looks like Figure 3. 

The folder icon at the right-hand side of the top 
button indicates that it is a file chooser; the title 
of the button is the name of the currently selected 
file, which is ‘(None)’ when the application is first 
run. If you click the button, a file chooser dialog 
will open (Figure 4). 

This provides a standard file browser; because we 
opened the window in ‘file open’ mode, it will only 
allow you to select a file that already exists on the 
file system. Use the browser to choose a file, and 
click ‘Open’; when the window closes, the title of 
the button will update to show the selected file, and 
the full file path of the selected file will be printed 
to the terminal window from which you launched 
the application. 

You can use a GtkFileChooserButton to opena 
browser which will select an existing file or folder, 
but the designers of GIK decided that you can’t 
use this method to choose the location to which a 
new file can be saved. For that, you need to create a 
GtkFileChooser dialog yourself. 

Modify the code above as follows: 


void main (int argc, char *argv[]) 


{ 
gtk_init (&argc, &argv); 
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Figure 5 


Name: newfild 

Save in folder. < (Jp: |gtk Create Folder ' 
2D Search Oigtkeb 17/09/18 

@Recently Used | fi gtke 3.1kB 0756 

@ akcss 112 bytes 01/10/18 

@pi fil gtko 58kB 0756 

Desktop fa gtktest 147kB 0756 


G File System @ Makefile 194 bytes Yesterday at 11:05 


Cancel OK 


A Figure 5A 
GtkFileChooserDialog 
to select a new file 


Figure6 — 


Figure 6A 
GtkColorButton 


Close window 


GtkWidget *win = gtk_window_new ( 
GTK_WINDOW_TOPLEVEL) ; 

GtkWidget *btn = 
gtk_button_new_with_label ( 
"Close window") ; 

g_signal_connect (btn, "clicked", 
G_CALLBACK (end_program), NULL); 

g_signal_connect (win, "delete_event", 
G_CALLBACK (end_program), NULL); 


GtkWidget *vbox = gtk_vbox_new (FALSE, 5); 
gtk_container_add (GTK_CONTAINER (win), 
vbox) ; 


gtk_box_pack_start (GTK_BOX (vbox), 
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> Figure 7 The colour 
picker dialog 
launched bya 
GtkColorButton 


> Figures A 
GtkFontButton 


Figure 7 


Pick a Colour 


Hue: 


Value: 


fc_btn, TRUE, TRUE, @); 
gtk_box_pack_start (GTK_BOX (vbox), btn, 
TRUE, TRUE, 0); 
gtk_widget_show_all (win); 
gtk_main (); 
} 


In this case, we create a button to open the dialog, 
and then have to manually create and open the 
dialog in the button handler. 

The dialog is created by calling 
gtk_file_chooser_dialog_ new, whose 
arguments are very similar to those for 
gtk_dialog_new_with_buttons that we saw in the 
previous chapter. First, the title of the dialog 
is provided, followed by a pointer to the parent 
window and then a flag which determines the 
behaviour of the dialog — in this case, it is set up 
to provide a file name and path to which a file 
can be saved. The remaining arguments are a 


— = 


Figure 8 


TITIIPI Ir) 


Sans 12: 


Peeeeeeeeeey 


Close window 
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Saturation: 


Colour name: 


213 |= Red: |77 |S| | 
69 |S Green: |152 |2 
9 |S Blue: [245 |> 
#4D98F5 | 

Cancel OK 


NULL-terminated list of pairs of labels and return 
values for the buttons at the bottom of the dialog. 

We create the dialog and call gtk_dialog_run 
when the button is pressed; the button handler 
then waits for the dialog to return. We then 
read the file path back from the file chooser using 
gtk_file_chooser_get_filename, as we did for the 
file open dialog. 

If you run this code and press the ‘Save file’ 
button, you’ll see that a file save chooser is slightly 
different from a file open chooser, in that it has a 
box to allow a new file name to be entered (Figure 5, 
previous page). 

Enter a new file name and select a location for the 
new file; when you press ‘OK’, the path to the new 
file will be printed to the terminal. 

There are several other predefined dialogs which 
can be added to an application just by including a 
button. Two of the more useful ones are the colour 
picker and the font chooser. 


Colour picker 

Sometimes you need to allow the user to select 

a colour — to determine how things will be 
highlighted, for example. This is easy to do with the 
GtkColorButton. (Note that whenever GTK 

refers to ‘colour’, it does so using the US spelling, 
without the ‘u’ — it’s acommon source of compile- 
time errors for those of us on the East side of 

the Atlantic!) 

Colours in GTK are stored as GdkColor data 
structures, which contain separate values for the 
red, green, and blue components of a colour. The 
GtkColorButton therefore operates on data stored 
as a GdkColor. 
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Figure 9 


Pick a Font 
Farmaly: Style: Size: 
Here’s an example of using a GtkColorButton: Siheraia ms regular = oa, 
Piboto Condensed Italic TU « 


Pibotolt au 


OM Serif ° 13 
4 > v 14 Vv 
Preview: 
void main (int argc, char *argv[]) f 
{ ‘abcdefghijk ABCDEFGHIJK 
gtk_init (&argc, &argv); 
GtkWidget *win = gtk_window_new ( Cancel OK 


GTK_WINDOW_TOPLEVEL) ; 
GtkWidget *btn = 
gtk_button_new_with_label ( 


A Figure 9 The font 


"Close window") ; either by clicking on the triangular colour map, by selector dialog 
. "ods " es launched by a 
g_signal_connect (btn, "clicked", entering RGB or HSV values, or by picking a colour ChE SaIBGon 
G_CALLBACK (end_program), NULL); from somewhere on the screen using the dropper 
g_signal_connect (win, "delete_event", tool (Figure 7). 
G_CALLBACK (end_program), NULL); When you click ‘OK’, the selected red, green, and 


blue values will be printed to the terminal. 
GtkWidget *vbox = gtk_vbox_new (FALSE, 5); 
gtk_container_add (GTK_CONTAINER (win), Font selector 

vbox) ; Another common operation is to select a font; 
this is used in many office applications, for 
example. GTK provides a font selector which works 
in the same way as the colour picker. Just change 
the GtkColorButton in the example above for 
a GtkFontButton: 


GtkWidget *fnt_btn = gtk_font_button_new (); 


gtk_box_pack_start (GTK_BOX (vbox), btn, g_signal_connect (fnt_btn, "font-set", 
TRUE, TRUE, @); G_CALLBACK (fnt_selected), NULL); 
gtk_widget_show_all (win); 
gtk_main (); And create the handler for the font-set signal: 
} 
static void fnt_selected ( 
We create the colour picker button in the same GtkFontButton *btn, gpointer ptr) 
way as the file chooser button, and we connect { 
to the color-set signal on it to detect when printf ("font = %s\n", 
the user has made a selection. The handler for gtk_font_button_get_font_name (btn)); 
this signal calls gtk_color_button_get_color } 
to read the selected value back into a GdkColor 
structure, and then prints out the red, green, and When run, a font button is shown with the currently 
blue values. selected font name (Figure 8). 

f you run this, you’ll see that the colour Pressing the font button opens the selector 
button shows a small rectangle of the currently dialog, which allows you to pick any of the fonts 
selected colour. (Figure 6, previous page). currently installed on the system (Figure 9). 

When clicked, the colour picker dialog is shown, When you click ‘OK’, the selected font name and 
which allows a colour to be set in various ways; size will be printed to the terminal. 1 
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Dan 
Lambton-Howard 


Dan is an 
independent game 
designer based in 
Newcastle upon 
Tyne, where he is 
lucky enough to 
make games for 
his PhD. 


@danhowardgames 


| You'll Need 


» PICO-8 
magpi.cc/pico8 


» Raspberry Pi 


» Keyboard 
and mouse 


Polish and release 
your PICO-8 game 


Time to go gold! Let's apply some final finishing touches to our 
retro space shooter, and release it into the wild 


skill in all of game development, actually 

finishing something. It’s the skill that 
turns a million-dollar idea into a million dollars 
and like any skill, the more you do it the easier it 
gets. Helpfully, the fantastic feeling of polishing, 
packaging and publishing your own game is truly 
addictive. With that in mind, we’l] be applying 
some final polish and ‘game feel’ to our plucky 
little shooter, creating an eye-catching title 
screen and covering how to actually release the 
darn thing. What a rush! 


T his final tutorial is about the most valuable 


Game feel 

The first thing we are going to polish, is the 
‘game feel’. Sometimes also called ‘juice’, game 
feel refers to the unique sensation of interacting 
with a game. It is created by everything from the 
tactile press of physical buttons, to graphical and 
audio feedback, to the movement and interaction 
of objects in a game. Good game feel is always 
satisfying. Think of Sonic the Hedgehog bouncing 
on robots, the roadie run in Gears of War, or the 
colourful spray of matching three in Candy Crush. 
Game feel is an important part of polishing a game. 


Screen shake 

One reliable way of creating satisfying game 
feel is to add a little bit of screen shake. Screen 
shake is a great way of communicating impact 
to a player. It works by jerking or shaking the 
game’s camera in response to events within the 
game. You’ll often see it used for explosions or big 
collisions in games, but indie developers Vlambeer 
have taken the art of screen shake to a new level 
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with titles such as Nuclear Throne and Luftrausers. 
Luckily for us, it is a relatively simple effect and 
easy to implement. 


Shake, rattle and roll 

Declare two new variables at the start: 
shkx,shky = 0,0. Add these to the update camera 
coordinates call: camera(camx+shkx, camy+shky). 
Next, declare two new functions, one to add screen 
shake and the other to update and reduce it. 
Check the part6code.p8 listing (overleaf) for how 
we did this. Add update_shake() to your update loop 
and now you can insert add_shake(x) at any point 
in your code where you want a bit more impact. 
We’ve sprinkled some when an enemy or the player 
is destroyed. Play around with the amount, but 
remember: a little shake goes a long way! 


M Screen shake is a great 
way of communicating 
impact to a player 


Little bits of dust 

Next, we are going to add particle effects 
to our game. Particles are exactly what they sound 
like. They are small graphical elements that are 
used to represent things like dust, smoke, debris 
from explosions, and so on. As well as improving 
the look of the game, they are another way of 
giving feedback to the player to improve game 
feel. To add them to our game, we will be creating a 
simple particle engine to update them — and, much 
like we did for screen shake, adding new particles 
anywhere we deem cool enough. 


Complete your 
game project with 
a retro arcade 
splash screen 


ATTACh 


We would have 
said ‘insert coin’, 
but there isn’t 

a coin slot on 
Raspberry Pi (yet) 


UF THE 


GREEN BLOBS 


PRESS 


Particular particles 

We need to create two new functions. See 
the code listing for details but essentially, we create 
new particles much like everything else, by adding 
it toa table. Is there anything tables in Lua can’t 
do? Our update function loops through this table 
and advances each particle’s age and colour so it 
looks darker the older it gets, until it eventually 
disappears. The real trick is where we add them 
to our game. We’ve created a particle trail from 
the player’s ship and added a bit of code to our 
create_explosion() function that also spews out 
particles in random directions. Very cool! 


Top and tail 

The last thing we need to do to our game 
before release is to add an awesome retro title 
screen. Currently our game launches straight into 
battle, catching players by surprise and feeling a 
little unfinished. Let’s fix this issue now so that it 
feels like a complete and polished game. To create 
our title screen, we can use all the unused room 
on our sprite sheet’s second tab. Let’s draw a cool 
sci-fi image that looks like something you would 
see blaring out of an arcade cabinet in the 1980s. 


To START °C 


State of the game 

We’ve gone for our iconic spaceship blasting 
through space, laser cannons flaring, and green 
blobs quivering in fear. It’s a powerful and, dare we 
say it, moving image, and one that will definitely 
attract an eager line of kids queuing up to play it in 
our virtual arcade. 

To implement it in game we create a new 

game State called title. Declare title = true in 
_init(). Then wrap the contents of _update() ina 
conditional so that it only runs if title is false. Do 
the same for _draw() as well. 


Setting the screen 

Now we need to actually add some code into 
our title state that will draw our image, and start 
the game if the player presses a button. Check 
the code listing for details, but it’s nothing more 
complicated than drawing sprites and printing 
some text. We’ve also added a timer that makes 
it so the player has to wait a second before they 
can progress. We don’t want them accidentally 
skipping our incredible artwork! To make it extra 
slick, we’ve added some new music and a chime 
SFX for the title screen. 


Polish and release your PICO-8 game 


Magri 


Top Tip 
Scratch an itch 


As well as being 
a great place to 
host your game, 
itch.io also runs 
regular PICO-8 
game jams. 
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part6code.p8 


DOWNLOAD 
THE FULL CODE: 


> Language: Lua 


ee1. 
ee2. 
0e3. 
e004. 
ee@5. 
006. 
007. 
008. 
ee9. 
e1e. 
11. 
Q12. 
013. 
14. 
15. 
016. 
017. 
18. 
19. 
20. 
Q21. 
Q22. 
Q23. 
Q24. 


25. 
26. 
Q27. 
028. 
Q@29. 
030. 
Q31. 
Q32. 
Q33. 
34. 
Q@35. 
036. 
Q37. 
038. 
Q39. 
e4e. 
041. 
042. 
043. 
e044. 
45. 
046. 
047. 
048. 
49. 
58. 
Q51. 
Q52. 
Q53. 
Q54. 


--new code reference 

--init() 

shkx,shky = @,@ --screen shake variables 
particles={} --table of particles 

title = true --title state bool 

timer = @ --timer for states 

music(16) --new title music 


--update() 
if title then 
timer+=1 
if btn(4) and timer>3@ then 
timer=0 
title = false 
sfx(11) 
music(@) 
end 
else 
--reset of update 
end 


--in player update loop 

if player.animtimer%2==0 then 
create_particle(player.x, 

player.y+3+rnd(2),-0.5,@) 

end 

--update screen shake 

update_shake() 


--sprinkle liberally... 
add_shake(8) 


--at end of if not gameover loop 
if gameover then 
timer+=1 
if btn(4) and timer>3@ then 
reload()--load all game data 
gameover=false 
_init() -- set game to initial state 
end 
end 


--draw() 

if title then 
cls() 
camera(@,@)--reset camera 
--title gfx 
spr(64,32,12,6,4) 
spr(118, 54,43) 
spr (72,86, 28, 2,2) 
spr(70,88,50,2,2) 
spr (104, 30,48,2,2) 
print('attack of the',36,72,3) 
spr(74,12,80,6,2) 
spr(106, 70, 80,6,2) 


@55. 
056. 
Q57. 
058. 
Q59. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
71. 
072. 
073. 
074. 
75. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
85. 
086. 
087. 
088. 
89. 
090. 
e091. 
92. 
093. 
094. 
95. 
096. 
097. 
098. 
99. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 


© magpi.cc/JbTKkP 
if timer>30 then 


print('press z to start',32,112,7) 
end 
rect(@,0,127,127,3) 
else 
--rest of draw code 
end 


--set camera shake 
camera(camx+shkx, camy+shky ) 


--other functions 
function add_shake(amount) 
local a=rnd(1) 
shkx+=amount*cos (a) 
shky+=amount*sin(a) 
end 


function update_shake() 
if abs(shkx)+abs(shky)<@.5 then 
shkx, shky=0,9 
else 
shkx*=-@.5-rnd(@.2) 
shky*=-0.5-rnd(@.2) 
end 
end 


function create_particle(x,y,vx,vy) 
local p={x=x, y=y, VX=vx, vy=vy, colour=10, age=0} 
add(particles,p) 

end 


function update_particles() 
for p in all(particles) do 
p.aget=1 
if p.age>15 then 
del(particles,p) 
elseif p.age>10 then 
p.colour=4 
elseif p.age>5 then 
p.colour=9 
end 
p.X+=p.VXx 
Pp-yt=p.vy 
pset(p.x,p.y,p.colour) 
end 
end 
--in create_explosion() 
--add particles to explosions 
for i=1,10 do 
local a=rnd(1) 
local vx=cos(a)*rnd(2) 
local vy=sin(a)*rnd(2) 
create_particle(x,y, vx, vy) 
end 
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Now for the tail 

So that’s the top done, but what about the 
tail? Currently when the player is defeated, they 
have to manually restart the game, which is not a 
good look. To polish this, we will add to our player 
update loop the option to restart the game by 
pressing a button. We do this by calling _init() and 
reload(), when the player presses a button during 
game over. We’ll also reuse our timer from the title 
state to adda slight delay before players can input, 
so they don’t miss the game-over message. 


Enter the cartverse 

Now that you have a pixel-polished piece of 
PICO-8 perfection, it’s time to get it in front of the 
world and reap the adoration you deserve. The first 
port of call should always be uploading your game 
to the Lexaloffle website so that your game joins 
the cartverse and appears for everyone in SPLORE, 


SCORE: 


Particle effects from the ship and explosions give a sense of 
movement. The screen shake helps as well! 


MéigPi 


slow 
cuRIOUS 


The Lexaloffle 


PICO-8’s built cartridge browser. To do this, website ig homeacor 

i i j i the cartverse, and the 
navigate to the submit section (magpi.cc/wwLy85) fepiseeycneula 
and upload your .p8 file there. Now other PICO-8 upload your finished 


peeps can play your game and comment on it! RICO-s'game 


Pick a format 

PICO-8 is like a Swiss Army knife when 
it comes to exporting. For example, create a 
standalone .bin for Raspberry Pi, Linux (64-bit), 
Windows and Mac. From the PICO-8 terminal, 
type EXPORT YOURGAME .BIN to create it. Another 
great place to upload is the indie game site itch.io, 
where you can post a web player version of your 
game. You can even set up to be paid through the 
site. To export for web, use EXPORT YOURGAME .HTML 
and you’ll get a.html and a .js file. Rename the 
html file to index.html and upload them both 
to itch.io. 


PICO-8 is like a Swiss Army knife 
when it comes to exporting 


To a bright future 

The quickest way to become a better game 
developer is to finish things and share them with 
people, and PICO-8 makes it easier than ever to do Top Ti p 
this. Raspberry Pi is the perfect platform for this 
little virtual console and has plenty of scope for Tweet ond 
expanding into arcade cabinets using the GPIO pins. greet 


PICO-8 has a very 
If you’ve followed these tutorials then let me know. active community 
I'd love to play your games and see what projects you on Twitter, use the 
have created. It’s been an absolute pleasure to have been ue ag 
your guide over these last few tutorials. Keep in touch: your game. 
@danhowardgames 
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Raspberry Pi 4 just got a lot cooler! The last four months of 
firmware updates have taken over half ag watt out of idle power 
and nearly a watt out of fully logded power. By Gareth Halfacree 


features to tempt users into upgrading: 
a more powerful CPU and GPU, more 
memory, Gigabit Ethernet, and USB 3.0 support. 

More processing power means more electrical 
power, and Raspberry Pi 4 is the most power- 
hungry member of the family. 

The launch of a new Raspberry Pi model is 
only the beginning of the story. Development 
is continuous, with new software and firmware 
improving each board long after it has rolled off 
the factory floor. 

Raspberry Pi 4 is no exception: since launch, 
there have been a series of updates which have 
reduced its power needs and, in doing so, enabled it 
to run considerably cooler. These updates apply to 


R aspberry Pi 4 launched with a wealth of new 
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M The Igunch of gd new 
Raspberry Pi model is only 
the beginning of the story @ 


any Raspberry Pi 4, whether you picked one up on 
launch day or are only just now making a purchase. 

This feature takes a look at how each successive 
firmware release has improved Raspberry Pi 4, using 
a synthetic workload designed - unlike a real-world 
task - to make the system-on-chip (SoC) get as hot 
as possible in as short a time as possible. 

Read on to see what wonders a simple firmware 
update can work. 


How we tested 


To test how well each firmware revision 
handles the heat, a power-hungry synthetic 
workload was devised to represent a worst- 
case scenario: the stress-ng CPU stress- 
testing utility places all four CPU cores under 
heavy and continuous load. Meanwhile, the 
glxgears tool exercises the GPU. Both tools 
can be installed by typing the following at 
the Terminal: 


sudo apt install stress-ng mesa-utils 


The CPU workload can be run with the 
following command: 


stress-ng --cpu @ --cpu-method fft 
The command will run for a full day at 


default settings; to cancel, press CTRL+C on 
the keyboard. 


To run the GPU workload, type: 
glxgears -fullscreen 


This will display a 3D animation of moving 
gears, filling the entire screen. To close it, 
press ALT+F,4 on the keyboard. 

For more information on how both tools 
work, type: 


man stress-ng 
man glxgears 


During the testing for this feature, both of 
the above workloads are run simultaneously 
for ten minutes. Afterwards, Raspberry Pi is 
allowed to cool for five minutes. 

The thermal imagery was taken at idle, 
then again after 60 seconds of the stress-ng 
load alone. 
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Launch firmware 
(June 2019) 


Finalised prior to production, 
the launch firmware is how 
every Raspberry Pi 4 rolled 
off the factory floor - fully 

functional, but not 
fully optimised. 


VLI firmware 
(July 2019) 


Released as an early beta, 
then withdrawn following 
the discovery of a bug, the 
VLI firmware enabled power 
management in the USB 3.0 
controller chip. 


VLI, SDRAM firmware 
(September 2019) 


This release combines the 
benefits of the earlier, and 
now fixed, VLI firmware 
plus modifications to the 
way Raspberry Pi's LPDDR4 
memory operates. 


Clocking, and 
load-step firmware 
(October 2019) 


The latest public release 
at the time of writing, this 
firmware update improves 
how the system-on-chip can 
increase and decrease its 
clock speed and voltage. 


Beta firmware 
(out soon) 


Due for public release soon, 
the beta firmware build 
includes power-saving 

tweaks to the system-on-chip 
operating voltage and the way 
HDMI video output works. 
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BASELINE TEST: : 
RASPBERRY PI 3b+ nN 


Already well established, Raspberry Pi 3 
Model B+ was the device to beat 


scene, Raspberry Pi 3 Model B+ was the 

must-have single-board computer. 
Benefiting from all the work that had gone into 
the earlier Raspberry Pi 3 Model B alongside 
improved hardware, Raspberry Pi 3B+ was — 
and still is - a popular device. Let’s see how 
well it performs before testing Raspberry Pi 4. 


B efore Raspberry Pi 4 came on the 


Bl idle (w) 

i : Load (W) 
An efficient processor and an improved a my 
design for the power circuitry compared to Raspberry peuerienee ss 
é 13 
its predecessor help keep Raspberry Pi 3B+ 
power draw down: at idle, the board draws 
just 1.91W; when running the synthetic 
workload, that increases to 5.77 W. 

Raspberry Pi 3B+ heat distribution (Idle) Raspberry Pi 3B+ heat distribution (Load) 


A thermal camera shows where the power 
goes. At idle, the system-on-chip is 
relatively cool while the combined USB 
and Ethernet controller to the middle- 
right is a noticeable hot spot; at load, 
measured after 60 seconds of a CPU- 
intensive synthetic workload, the SoC is 
by far the hottest component at 58.1°C. 


| Thermal Throttling | == CPU Temperature CPU Clock === CPU Clock (Moving Average) 


Testing Period Cooldown 


This chart measures Raspberry Pi 3B+ Sa ac ara a epatisien Peart ger ert teerane arenes as 
CPU speed and temperature during a 
ten-minute power-intensive synthetic 
workload. The test runs on both the CPU 
and GPU, and is followed by a five-minute 
cooldown. Raspberry Pi 3B+ quickly 
reaches the ‘soft throttle’ point of 60°C, 
designed to prevent the SoC hitting the 
hard-throttle maximum limit of 80°C, 
and the CPU remains throttled at 1.2GHz 
for the duration of the benchmark run. 


Frequency (MHz) 
Temperature (Degrees Celsius) 


Time (Seconds) 
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RASPBERRY Pl 4 


LAUNCH FIRMWARE 


The fastest Raspberry Pi ever made 
demanded the most power 


range of improvements over Raspberry 
Pi 3B+, including a considerably more 
powerful CPU, a new GPU, up to four times 
the memory, and USB 3.0 ports. All that new 
hardware came at a cost: higher power draw 
and heat output. So let’s see how Raspberry 
Pi 4 performed at launch. 


) aspberry Pi 4 Model B launched with a 


Raspberry 
There’s no denying it, Raspberry Pi 4 was a mer 
hungry beast at launch. Even idling at the 
Raspbian desktop, the board draws 2.89 W, 

Raspberry 


hitting a peak of 7.28W under a worst-case Pig Launch 
synthetic CPU and GPU workload - a hefty ga 
increase over Raspberry Pi 3 B+. 


Thermal imaging shows that Raspberry 
Pi 4, using the launch-day firmware, 
runs hot even at idle, with hot spots 

at the USB controller to the middle- 
right and power-management circuitry 
to the bottom-left. Under a heavy 
synthetic load, the SoC hits 72.1°C by the 
60-second mark. 


Raspberry Pi 4 manages to go longer than 
Raspberry Pi 3 B+ before the synthetic 
workload causes it to throttle; but 
throttle it does after just 65 seconds. As 
the workload runs, the CPU drops from 
1.5GHz to a stable 1GHz, then dips as low 
as 750MHz towards the end. 


Frequency (MHz) 


Raspberry Pi 4 (Idle) 


=== CPU Temperature 


CPU Clock 


Time (Seconds) 
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I Idle (w) 
Load (W) 


Lower is better 


Raspberry Pi 4 (Load) 


=== CPU Clock (Moving Average) 


Temperature (Degrees Celsius) 
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RASPBERRY PI 4 
VLI FIRMWARE 


USB power management brings some relief for Raspberry Pi heat 


he first major firmware update 
T developed for Raspberry Pi 4 Bi tale (w) 
brought power management P| Load (W) 
features to the Via Labs Inc. (VLI) ae! td Aegan ic hehe 
USB controller. The VLI controller is 


responsible for handling the two USB 3.0 
ports, and the firmware update allowed it 


to run cooler. 
Raspberry 


Pi 4 Launch 


} Power Draw | — 


Even without anything connected to 

Raspberry Pi 4’s USB 3.0 ports, the z 02 
VLI firmware upgrade has a noticeable re 

impact: idle power draw has dropped to 

2.62 W, while the worst-case draw under 

a heavy synthetic workload sits at 7.01 W. 


Raspberry Pi 4 VLI firmware (Idle) Raspberry Pi 4 VLI firmware (Load) 


The biggest impact on heat is seen, 
unsurprisingly, on the VLI chip to the 
middle-right, the VLI firmware helps 
keep the SoC in the centre and the power- 
management circuitry at the bottom-left 
cooler than the launch firmware. The SoC 
reached 71.4°C under load - a small, but 
measurable, improvement. 


| Thermal Throttling | == CPU Temperature CPU Clock == CPU Clock (Moving Average) 


Enabling power management on the 

VLI chip has a dramatic impact on 
performance in the worst-case synthetic 
workload: the throttle point is pushed 
back to 77 seconds, the CPU spends 
more time at its full 1.5GHz speed, and it 
doesn’t drop to 750MHz at all. The SoC 
also cools marginally more rapidly at the 
end of the test. 


Frequency (MHz) 


Temperature (Degrees Celsius) 


Time (Seconds) 


70 | magpicc | Thermaltesting Raspberry Pi 4 


FEATURE | Mag? [a 


RASPBERRY Pl 4 
VLI, SURAM FIRMWARE 


With VLI tamed, it's the memory's turn now 


he next firmware update, Wl idle (w) 
designed to be used alongside the Ss) Load (W) 
VLI power management features, Raspberry [i -_ 

Pi 3 B+ Lower is better 


changes how Raspberry Pi 4’s memory 
- LPDDR4 SDRAM - operates. While 


having no impact on performance, it 
helps to push the power draw down still Raspberry pat | 
further at both idle and load. “pee 
Pi 4 VLI 
As with the VLI update, the SDRAM update 
brings a welcome drop in power draw at 
both idle and load. Raspberry Pi 4 now Raupbenry 


draws 2.47 W at idle and 6.79 W running PLGNEEs 
a worst-case synthetic load — a real 
improvement from the 7.28 W at launch. 


Raspberry Pi 4 (Idle) Raspberry Pi 4 (Load) 


Thermal imaging shows the biggest 
improvement yet, with both the SoC 
and the power-management circuitry 
running considerably cooler at idle after 
the installation of this update. After 60 
seconds of load, the SoC is noticeably 
cooler at 68.8°C — a drop of nearly 3°C 
over the VLI firmware alone. 


A cooler SoC means better performance: 
the throttle point under the worst-case 
synthetic workload is pushed back to 
109 seconds, after which Raspberry Pi 4 
continues to bounce between full 1.5GHz 
and throttled 1GHz speeds for the entire 
ten-minute benchmark run — bringing 
the average speed up considerably. 


=== CPU Temperature CPU Clock === CPU Clock (Moving Average) 


Frequency (MHz) 
Temperature (Degrees Celsius) 


Time (Seconds) 
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RASPBERRY PI 4 VLI, SDRAM, 
CLOCKING, ANU LOAD-STER 
E | LY MV WA | a September brought still more firmware improvements 


eptember 2019’s firmware update 

includes several changes, while Ee BB tale (w) 
ae ee aspberry 

bringing with it the VLI power Pi3 Bt Load (W) 


management and SDRAM firmware 
updates. The biggest change is how 


Lower is better 


the BCM2711Bo SoC on Raspberry Pi 4 faoet 
increases and decreases its clock-speed Pesuaware 


2.89 
Raspberry 


in response to demand and temperature. 
Pi 4 VLI 
Raspberry 247 


Pi 4 VLI, 


The September firmware update has SDEAn 
incremental improvements: idle power 
draw is down to 2.36 W and load under the 


‘ Raspberry 2.36 
worst-case synthetic workload to a peak ne 
of 6.67W, all without any reduction in Clocking 
raw performance or loss of functionality. 
Raspberry Pi 4 VLI, SDRAM, Clocking firmware (Idle) Raspberry Pi 4 VLI, SDRAM, Clocking firmware (Load) 


Improved processor clocking brings 

a noticeable drop in idle temperature 
throughout the circuit board. At load, 
everything’s improved — the SoC peaked 
at 65°C after 60 seconds of the synthetic 
workload, while both the VLI chip and the 
power-management circuitry are clearly 
cooler than under previous firmwares. 


| Thermal Throttling | == CPU Temperature CPU Clock === CPU Clock (Moving Average) 


With this firmware, Raspberry Pi 4’s 
throttle point under the worst-case 
synthetic workload is pushed back all the 
way to 155 seconds - more than double 
the time the launch-day firmware took 
to hit the same point. The overall average 
speed is also brought up, thanks to more 
aggressive clocking back up to 1.5GHz. 


Frequency (MHz) 
Temperature (Degrees Celsius) 


Time (Seconds) 
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RASPBERRY PI 4 
BETA FIRMWARE 


Currently in testing, this beta release is cutting-edge 


on their laurels. Beta firmware 

is in testing and due for public 
release soon. It brings with it many 
improvements, including finer-grained 
control over SoC operating voltages and 
optimised clocking for the HDMI video 
state machines. 


N obody at Raspberry Pi is resting 


The beta firmware decreases power draw 
at idle to reduce overall power usage, 
while tweaking the voltage of the SoC to 
drop power draw at load without harming 
performance. The result: a drop to 2.10W 
idle, and 6.41 W at load — the best yet. 


The improvements made at idle are clear 
to see on thermal imaging: the majority 
of Raspberry Pi 4’s circuit board is below 
the bottom 35°C measurement point for 
the first time. After 60 seconds of load, 
there’s a smaller but still measurable 
improvement, with a peak measured 
temperature of 64.8°C. 


While Raspberry Pi 4 does still throttle 
with the beta firmware, thanks to 

the heavy demands of the synthetic 
workload used for testing, it delivers 
the best results yet: throttling occurs at 
the 177s mark while the new clocking 
controls bring the average clock speed 
up markedly. The firmware also allows 
Raspberry Pi 4 to up-clock more at 
idle, improving the performance of 
background tasks. 


Raspberry 
Pi3 B+ 


Raspberry 
Pi 4 Launch 
Firmware 


Raspberry 
Pi 4 VLI 


Raspberry 
Pi 4 VLI, 
SDRAM 


Raspberry 
Pi 4 VLI, 
SDRAM, 
Clocking 


Raspberry 
Pi 4 Beta 
Firmware 


1600 


1350 


1100 


Frequency (MHz) 


To upgrade your Raspberry Pi to the latest 
firmware, open a Terminal window and enter: 


sudo apt update 
sudo apt full-upgrade 


Now restart Raspberry Pi using: 


sudo shutdown - r now 
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Raspberry Pi 4 beta firmware (Idle) 


w= CPU Clock 


=== CPU Temperature 


200 400 


Time (Seconds) 


i idle (w) 
)) Load (w) 


Lower is better 


7.28 


7.01 


6.79 


6.67 


Raspberry Pi 4 beta firmware (Load) 


=== CPU Clock (Moving Average) 


600 


Temperature (Degrees Celsius) 
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KEEP COOL WITH 
RASPBERRY PI 4 ORIENTATION 


Firmware upgrades offer great gains, but what 
about putting Raspberry Pi on its side? 


hile running the latest firmware 
W will result in considerable 
power draw and heat 
management improvements, there’s 
a trick to unlock even greater gains: 
adjusting the orientation of Raspberry Pi. 
For this test, Raspberry Pi 4 with the beta 
firmware installed was stood upright with 
the GPIO header at the bottom and the 
power and HDMI ports at the top. 


Simply moving Raspberry Pi 4 into a 
vertical orientation has an immediate 
impact: the SoC idles around 2°C lower 
than the previous best and heats a lot 
more slowly - allowing it to run the 
synthetic workload for longer without 
throttling and maintain a dramatically 
improved average clock speed. 

There are several factors at work: 
having the components oriented 
vertically improves convection, allowing 
the surrounding air to draw the heat away 
more quickly, while lifting the rear of the 
board from a heat-insulating desk surface 
dramatically increases the available 
surface area for cooling. Time (Seconds) 


== CPU Temperature CPU Clock === CPU Clock (Moving Average) 


Frequency (MHz) 
Temperature (Degrees Celsius) 


. 5 Raspberry Pi 4 
This chart shows how long it took to ies tices = ee 


reach the throttle point under the ee ne (cn si 
synthetic workload. Raspberry Pi 3B+ sits 


at the bottom, soft-throttling after just maapery ATE, 
19 seconds. Each successive firmware ; 
" 7 Raspberry Pi 4 VLI, 155 
update for Raspberry Pi 4, meanwhile, SDRAM, Clocking 
pushes the throttle point further and Raspberry Pi 4 Beta 
further - though the biggest impact anaes 
can be achieved simply by adjusting 
Raspberry Pi’s orientation. 


Raspberry Pi 4 Beta 
Firmware (Vertical) 
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REAL WORLD TESTING 


Synthetic benchmarks aside, how do the boards perform with real workloads? 


to get a real idea of the difference in 

performance between Raspberry Pi 3B+ and 
Raspberry Pi 4. The synthetic benchmark chosen 
for the thermal throttle tests performs power- 
hungry operations which are rarely seen in real 
world workloads, and repeats them over and over 
again with no end. 


[ ooking at the previous pages, it’s hard 


Compiling Linux 
In this test, both Raspberry Pi 3B+ and Raspberry 
Pi 4 are given the task of compiling the Linux 


Raspberry Pi 3B+ throttles very early 

on in the benchmark compilation test 
and remains at a steady 1.2GHz untila 
brief period of cooling, as the compiler 
switches from a CPU-heavy workload to 
a storage-heavy workload, allows it to 
briefly spike back to its 1.4GHz default 
again. Compilation finished in 5097 
seconds — one hour, 24 minutes, and 

57 seconds. 


Frequency (MHz) 


The difference between the synthetic 
and real world workloads is clear to 
see: at no point during the compilation 
did Raspberry Pi 4 reach a high enough 
temperature to throttle, remaining at 
its full 1.5GHz throughout - bar, as with 
Raspberry Pi 3 B+, a brief period when a 
change in compiler workload allowed it 
to drop to its idle speeds. Compilation 
finished in 2660 seconds - 44 minutes 
and 20 seconds. 


Frequency (MHz) 


1100 


kernel from its source code. It’s a good example 
of a CPU-heavy workload which occurs in the 
real world, and is much more realistic than 

the deliberately taxing synthetic workload of 
earlier tests. 

With this workload, Raspberry Pi 4 easily 
emerges the victor. Despite its CPU running only 
100MHz faster than Raspberry Pi 3B+ at its full 
speed, it’s considerably more efficient — and, 
combined with the ability to run without hitting 
its thermal throttle point, completes the task in 
nearly half the time. 


=== CPU Temperature === CPU Clock 


3000 4000 


Time (Seconds) 


=== CPU Temperature === CPU Clock 


500 1000 1500 


Time (Seconds) 
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== CPU Clock (Moving Average) 


5000 


== CPU Clock (Moving Average) 


Temperature (Degrees Celsius) 


Temperature (Degrees Celsius) 
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TIM GOVER ON 
FIRMWARE UEVELUPMENT 


Bridging the worlds of hardware and software, Tim Gover focuses on the firmware 


4d ’m a software engineer and work on the 
co™ firmware,” Tim Gover explains, after having 


ae 
TBO 


<=> 
Tim 
Gover 


Tim Gover is a 
software engineer 
at Raspberry Pi, 
where he works 
on firmware for 
booting, power 
management, 

and displays. 


raspberrypi.org 


P Tim Gover's toolbox: 


Raspberry Pi 4 with 
microSD breakout 
board, logic analyser, 
and UART serial 
communications on 
the laptop 


sent across the very latest beta firmware 
build for testing. “I spend most of my time 
working on the bootloader, including support 
for board bring-up and manufacturing. | also get 
involved with display stuff like the HDMI and HVS 
firmware drivers.” 


Just what is firmware? 

“On Raspberry Pi, firmware normally refers to 
software running a dedicated processor — instead 
of the main CPU - to support complex hardware. 
There are multiple firmwares, including the 
BCM2711 ROM, bootloader, USB 3.0 controller, 
WiFi, and the VideoCore start.elf.” 

Raspberry Pi 4 handles things a little 
differently to previous models, however - in 
particular, when it comes to the part known as the 
second-stage bootloader. 
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“The second stage bootloader is responsible for 
initialising the SDRAM and loading the VideoCore 
firmware into memory from external storage — 
microSD/Ethernet/USB. It’s loaded by the ROM 
directly into the VideoCore L2 cache, so must be 
small, and is equivalent to bootcode.bin which 
was loaded from the microSD on Raspberry Pi 3 
and earlier.” 

To allow for the bootloader to be easily 
upgraded, Raspberry Pi 4 comes with something 
earlier models do not: a small amount of on- 
board storage known as an electrically erasable 
programmable read-only memory (EEPROM). 

“An EEPROM for the second stage on BCM2711 
seems to be anice middle ground, compared 
to requiring a microSD (or more expensive on- 
board eMMC) for a bootcode.bin,” Tim explains. 
“Tt was never going to be practical to bake more 
functionality into the chip ROM. Relatively 
simple USB 2.0 support for mass storage has been 


Msi 


‘ 
MI 
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We've already committed to supporting USB 
mass storage boot and |IPv6 network boot 


replaced with Gigabit Ethernet plus USB 3.0 over 
PCI Express. These driver interfaces are much 
more complicated, and also tend to require DMA 
access to SDRAM.” 


“The new DVFS code adds more operating points 
for Arm [CPU] frequencies,” says Tim, “and picks 
the best voltage according to the operating point. 
The voltage also has to be suitable for all the other 
blocks on the chip - e.g. V3D - so this is a fairly 
complicated change.” 

There are other, more minor changes, too, 
including a more sensible default for Raspberry 
Pi 4’s USB On-The-Go (OTG) functionality. “By 
default the USB OTG controller is not enabled 
unless dtoverlay=dwc-otg is added to config.txt, 
explains Tim. “This saves about 35 mW for most 


” 


users who only use the USB-C connection 
for power.” 


“Dynamic HDMI clocking - the HDMI state 
machine clock is now dynamically changed to 
match the resolution requirements using the 
updated firmware clock infrastructure. This 
makes it better at reducing the idle power to 

the minimum required for the current display 
configuration — e.g. a single high-definition 
display should have lower idle power consumption 
than a 4Kp30 or dual-display configuration.” 


“We’ve already committed to supporting USB 
mass storage boot and IPv6 network boot, so that 
will keep me busy for a while!” 
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Perfect option for your DIY or high-volume commercial projects 


Fits all kinds of HATs 
Ideal PoE HAT case 


Use with HAT or Pi alone 
Simple and professional 


Rapid, tool-free assembly 
GPIO cable pass-through 


Two wall mount options 
Well ventilated 


Designed and manufactured in North America 
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GPIO Xmas Tree 


> pocketmoneytronics > magpi.cc/Q5eraD >» £4/S5 


LIGHTS: 
5x LEDs 


PROGRAMMING 


LANGUAGES: 
Scratch, Python 


TIME TO FINISH: 
Roughly five 
minutes 


While there's 
nowhere to hang 
your baubles, this 
tiny tree is fun 

to program 


Verdict 


This fun little 
project will make 
your Raspberry Pi 
work desk festive, 
or make a young 
maker's first steps 
at Christmas 
wonderful. 


9, 10 


A mini, programmable Christmas tree accessory that's easy to code in 
Scratch and Python. Rob Zwetsloot decks his Raspberry Pi with one 


e love all the GPIO Christmas 
W decorations that you can get for 
Raspberry Pi, and while we also really 
enjoy putting stuff together like those Christmas 
kits, we sometimes just like to plug something in 
and see it go. 

The GPIO Xmas Tree is something like that — 
and probably the easiest one to code yet! It’s also 
nice and small, sitting over six GPIO pins rather 
than taking up all 40. This way, you can adda 


M One of the unigue things 
about this tree is that 
you can program it 
with Scratch! @ 


little festive flair to your Raspberry Pi, while still 
working on other projects that require the use of 
some GPIO pins. 


Easy coding 

One of the unique things about this tree is that you 
can program it with Scratch! Scratch on Raspberry 
Pi has a built-in GPIO library, allowing you to code 
physical objects, including this tree’s five LEDs. 

This is one of the few cases, though, where 
something so simple is much easier to do via 
Python, especially thanks to the GPIO Zero library, 
requiring less than ten lines of code to create a 
wonderful twinkling effect! 

We quite adore this little tree — it’s cheap and 
cheerful and could be someone’s first Raspberry 
Pi project on Christmas morning, with a quick and 
very cool result. 
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10 Best: 


Christmas 
projects 


Liven up your living room with these 
fantastic holiday builds 


e love seeing people make their own festive 
W projects at this time of year, and we always 

try to make sure we include one of our own 
every December issue. Check out page 40 for this 
year’s smart lights. If you’re still feeling a bit humbug 
about it all, here are ten other incredible Christmas 


projects to get you in the spirit. 0 


A Minecraft-controlled 
Christmas tree 


VR to RL 


Minecraft can be hacked with a bit of code so that you can make 
it do as you wish. But this also means that, via more code, it can 
interact with reality. So, David Stevens has made it so changes to 
the Christmas tree in the game alter the lights outside. Clever! 


magpi.cc/DdipTY 


80 | magpicc | 10 Best Christmas projects 
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a Smart Gingerbread House 


Edible electronics, sorta 


Gingerbread is delicious, and houses made from it are a staple decoration in 
some homes. Estefannie takes it a step further and gives hers lights and motors. 
Honestly, ours wouldn't last long enough for us to do that. 


magpi.cc/AG4pbj 


v Raspberry Pi 
Christmas Tree 
Light Show 


Advanced tree lights 


We quite like the lights we made 
earlier in the mag, but if you want to 
do some serious tree hacking, we 
suggest taking a look at this amazing 
project on Instructables. 


magpi.cc/irP5Nh 


aospberry i Secret Santa? 


‘teas Bantage 1s here to help find cut 89 whoo 


4 Secret Santa 
Babbage 


Upgrade your office 


If you find fishing names out of a hat 

a bit old-fashioned, you can always 
have Babbage Bear choose for you. 
Squeeze his hand and he'll print out a 
piece of paper showing who you need 
to buy for. £5 limit, though. 


magpi.cc/Hbaw2t 


MéigPi 


This is a serious amount of lights all 
over this house to be controlled by 

a Raspberry Pi. David does so using 
a phone to connect to Raspbian 

via VNC. 


Some people like to turn on the 
fireplace video on Netflix; others 
prefer to create digital fires of 
their own. This one also does the 
impossible and can cycle through 
different colours of flame. 


This is a fun Scratch project that allows you to go to sleep happy 
in the knowledge that you won't miss Santa. Maybe you'll find out 
exactly how big his sack of toys is. 


A modern take on the palm readers you 
used to find on seaside piers, although this 
machine takes a more binary approach: are 
you naughty... or nice? Think happy thoughts. 


Magri 
A couple years ago, we made a little en age 


project that allowed you to turn a copy i So 
of The MagPi into a light-up Christmas oo * 
card. Grab the PDF, print the cover on 
card, and give it a go! 


Another project where a house has been kitted out with full Raspberry Pi- 
powered lights - only this one plays music and syncs to it as well. Especially 
phat dubstep tracks. 


Made something with Raspberry Pi for this holiday 
season? Send us photos on Twitter (@TheMagPi) 
or via email (magpi@raspberrypi.org) so we can 
hopefully feature you in the next issue! 
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Learn computing systems 
with Raspberry P1 


It's one thing to learn about computers, and quite another to learn about computing 


— The Elements of Computing Systems 


Noam Nisan and 
Shimon Shocken 


CREATOR 


Price: 
£25/$35 
magpi.cc/XRyTzM 


Modern computing systems are 
built on a stack of technologies. 
Right at the top, you have the 
operating system and high-level 
languages like Python. These 
sit above a virtual machine that 
communicates via assembly 
language to the hardware, which 
itself is built on a system of 
chips and logic gates. Head down 
and you’ ll hit physics. 
Professional programmers 
often don’t know what’s going 
on deep down in the computer 
system. They rely on the fact 
that what they do works. 


The Elements of Computing 
Systems is the book behind the 
more popular Nand to Tetris 
course (aka ‘nand2tetris’). 
Using a hardware simulator to 
build a NAND (NOT-AND) gate, 
the latter is then used to build 
all the other chips and gates 
that form a computer. You then 
use that to build a general- 
purpose computer system, 
called Hack; and a compiler, 
called Jack. You use these to 
build an operating system. 

The corresponding website 
(nand2tetris.org) has projects, 


software installation, and 
sample programs made 
with Jack (including the 
aforementioned Tetris). H 


J 


GEEKSFORGEEKS 
The GeeksforGeeks site should be 


bookmarked anyway, but take a look at the 


Computer Organization and Architecture 
tutorials section. 
magpi.cc/R622SJ 


STACK EXCHANGE 

Stack Exchange has two useful boards for 
you: Computer Science (magpi.cc/T4uM4h) 
and Electrical Engineering 
(magpi.cc/infrdB). Sign up with both. 
stackexchange.com 
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CPU SIMULATOR 


There are countless CPU simulation programs 
and sites to explore, many based on the Little 
Man Computer model (magpi.cc/NAphAm). 
Why not start with this offering? 
tools.withcode.uk/cpu 


L Computer Architecture 


David Comes mreduciion 
Wentzlaff 


CREATOR 


Price: 
Free 


magpi.cc/ikxjQd 


Department of Ebect 


Commuter Architecture 


Princeton University’s 
Computer Architecture course 
is on Coursera and is widely 
regarded as one of the best 
‘all-rounders’. The course 
covers architecture, pipelining, 
cache, superscalar, and works 
its way up to multiprocessors. 
The course is led by David 
Wentzlaff, Associate Professor, 


(BS: David Wentzlaff 


vical Engineering 


Electrical Engineering at 
Princeton, and he leads you 
through the concepts. By the 
end of the course, you will 
have a good understanding 
of the different types of 
processor architectures. 

You can enrol on the course 
for free, although there is no 
certificate for completion. HI 


; Computer Organization 


Parrot 


BB tttoriatacons 


Price: 
£100 / $130 


CREATOR 


magpi.cc/kx2Cr7 


Computer Organization 
starts with computer and 
performance, before moving 
on to processor unit design 
and memory system design, 
then input-output design and 
pipeline design techniques. 
Of particular interest for 
Raspberry Pi fans is its coverage 
of RISC - reduced instruction 
set computers. 


Computer Organizanen 


It’s developed using the GATE 
(Graduate Aptitude Test in 
Engineering) syllabus, making 
it useful for undergraduates. 
But the course content of use to 
anybody interested in learning 
computing architecture. 

The price is listed at $132, 
but it’s frequently on sale (it 
was S10 at the time we went to 
press, so look out for that). Hl 
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Add these titles to your 
computing bookshelf 


CODE: THE HIDDEN 
LANGUAGE OF COMPUTER 
HARDWARE AND 
SOFTWARE 

This book is famous for 
explaining complex concepts 
to non-technical people. It 
doesn't teach anything about 
programming, but is a great 
place for absolute beginners. 
magpi.cc/BVUnby 


BUT HOW DO IT KNOW? 
This book is designed to bridge 
the gap between knowing the 
major parts of a computer and 
starting a complete course. 
The first three chapters are 
available on Google Books 
(magpi.cc/tQrtY5). 
buthowdoitknow.com 


ALGORITHMS TO LIVE BY 
Learn how computer science 
can be applied in the real 
world (and gain a further 
appreciation for the computing 
concepts in the meantime). 
magpi.cc/ynWm9S 
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V Designing a PCB is no 
simple feat, and this 
one really makes the 
thermal camera project 
a bit easier for Liz 


Liz Clark 
aka Blitz City DIY 


The creator of Blitz City DIY talks to us about making amazing 
YouTube videos of cool builds 


> Day job Vlogger | 
ot everyone has been 

N tinkering with electronics 
for decades. Some are 

new to the hobby, and it’s easy 

to figure out why: information 

on the internet is easier to obtain 

than ever, and the low cost 

of Raspberry Pi has helped to 

further make it accessible. Liz is 

one of those newcomers. 

“T actually got a bit of a ‘late’ 
start to making (although ’ma 
firm believer that it’s never too 


> Community role YouTuber | 


late to learn something new),” 
Liz tells us - and we completely 
agree. “I was in college and 
decided that I should try and 
learn some coding without really 
knowing what that meant. I was 
majoring in music technology, so 
I began my search in the music 
arena and learned about Arduino 
and all of the MIDI projects that 
people were beginning to make 
with them. I dabbled a bit off 
and on with it, but it wasn’t until 
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> URL magpi.cc/FDpqSi 


about four years ago that I really 
got serious about it and now 
I’m doing a bit of everything: 
CircuitPython, 3D printing and 
design, PCB design, and of course 
a hearty portion of Raspberry Pi. 
Outside of hardware, though, 
Iam a long-time avid knitter, 
cross-stitcher, and sewer.” 

We'd also argue that textile 
arts are a form of making as well, 
just a bit more low-tech. 


Why did you start your channel? 
Related to my ‘late’ start in 
making, I had been out of 
college for about two years 

and was starting to feel a little 
stuck. I really wasn’t working 

on any creative projects and I 
was worried that I was going to 
permanently fall into that rut 
working full-time. I also have a 
video background and I hadn’t 
filmed and edited anything for 
fun at that point since school, so 
my channel was basically born 
from a place of worry and/or 
quarter-life crisis. It was a very 
surreal and odd thing for me to 
do because I definitely lean more 
toward the introverted side, so 
the idea of me talking on camera 
about things was completely 
outside of my comfort zone. 
However, ve become a lot better 


A Raspberry Pi NolIR Camera Module isn't the only IR camera for 
Raspberry Pi - Adafruit also has the AMG8833 Grideye 


M1 actually got a bit of a ‘late’ 
Start to making (although I'm a 
firm believer that it's never too 

ah Aline Sento maby eaten eh ouna te a easier cane rods late to learn something new) 


server. We like the 3D-printed mounting to cut down on the footprint 
at speaking as a result, and my Linux and all things 
goal for working on creative single-board computers. Blitz City DIY Raspberry Pi projects 
projects and keeping up my 
video skills wouldn’t have been Any future Raspberry Pi plans? “| rigged up a thermal camera using the AMG8833 thermal 
possible without my channel. It’s I’m actually working on a big camera module from Adafruit. It was before | had a 3D printer, 
also led to some really amazing Raspberry Pi project right now. so the housing was in a modified picture frame. That project 
opportunities that otherwise I It’s going to be a MIDI-powered also ended up becoming my first PCB - | designed up a quick 
wouldn’t have had, so I’m so glad robot xylophone. I’m using tiny Bonnet-type board tose easily route the thermal camera 
I took the initial risk. solenoid motors to strike the keys er 5 eRe a : ; 

: ; also have an OpenMediaVault instance running ona 
ona glockenspiel and I’m using Raspberry Pi that | use as a home media server and network 

When did you first learn about MIDI-in over UART on Raspberry backup for my computers, and | do run Steam Link ona 
Raspberry Pi? Pi. lalso made a custom HAT PCB Raspberry Pi as well. | think that’s one really cool thing about 
I first learned about Raspberry to connect up the MIDI-in circuit Raspberry Pi in general: you can run a lot of different types of 
Pia couple of years ago, around and multiplexers to Raspberry Prplecs Sonic m ie Mele Sway einone favours ot nur 
the time that I was starting my Pi’s GPIO. It’s definitely a concept Seco CL BU ce 
channel. It honestly seemed a that’s been done before, but 
little mysterious to me at first having a music background and 


because I wasn’t quite sure what being a former mallet player, 
it was or what it did, but I quickly I’m really excited to create my 
fixed that and fell in love with own version. Hi 
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his Month in 
aspberry P1 


oolest Projects 2020! 


Next year's Coolest Projects events are coming together 


e love the Coolest Projects — it’s 
amazing to see the imagination and 


‘ / , 


ingenuity of young makers in multiple Prue ’ b 
fields. More details about the upcoming 2020 “at oe ip 
events in the USA and UK were revealed — as well “tT Z MARCH 72020 
as the opening of registration — as we were going to THE WORLD'S LEADING i 
print, so we’ve squeezed them in here! TECHNOLOGY EXHIBITION 


The event is both a celebration and an exhibition FOR YOUNG PEOPLE 
to inspire and enable innovation, creativity, 
entrepreneurship, and technology skills in young 
makers. Join us to support hundreds of young 
innovators and celebrate their accomplishments. 
Participants and visitors will also get the 
chance to take part in exciting hands-on tech 
activities, see inspirational speakers and leading 
technology experts, and join a global community of 
digital makers. 

All projects are welcome in any programming 


##COOLESTPROJECTS 8. 


Coolest Projects USA 

© 7 March 2020 

9 Discovery Cube Orange County, CA, USA 
> coolestprojects.org/usa 

@ magpi.cc/fKpgFA 


language or using whatever hardware you like, *opOlEst aN 

whether you’re a beginner or a seasoned creator. pROUE 

You can work as an individual or as part of a team 4 

of up to five. Coolest Projects events are open THE WORLD'S LEADING ‘ 4APRIL 2020 


to all levels of skill; the focus is on creativity, 
participation and, most of all, having fun! 


TECHNOLOGY EXHIBITION 
FOR YOUNG PEOPLE Se 


FCOOLESTPROIECTS meray 


Coolest Projects UK 

& 4 April 2020 

Q The Sharp Project, Manchester UK 
> coolestprojects.org/uk 
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Christmas 
comes early! 


Some makers have been getting their Christmas projects sorted well in advance 


e often get messages and emails from 
W readers who would love us to feature 

their project — and usually we do in our 
project showcase feature! Unfortunately, when it 
comes to seasonal projects, we don’t always have 


time or space — so here’s a couple we were sent this 
year that we’d love to show off a bit of! H 


Interactive Nativity Scene 
MAKER: Tomasz Siron 


Tomasz was so keen to let us know about his 
plans, he messaged us in March about his project. 
It’s a nativity scene in Poland that you can control 
via the internet! 

“T wanted to show off our original project, 
which I built together with friends,” Tomasz 
said. “There is a crib controlled by the internet. 
Everyone can control the crib. The site was created 
using Bootstrap and jQuery. Hosting is on our 
own basement server. We use a virtual machine 
(Debian) on Proxmox. 

“We used a Raspberry Pi 3, two IP cameras, and 
two Arduino Nanos... In the crib, we installed the 
computer speaker — carols were heard around 
the city centre. I built it with my colleagues over 
about a month.” 

He’s brought it back for another year. Find out 
more here: magpi.cc/nXqYzp. 


Raspberry Pi Christmas Lights 
MAKER: Greg Macaree 


We got this through via email from Greg in early 
November, and it’s a project that he’s been 
working on and upgrading for a while now! 

“At the end of last year, I added a string of 500 
pixels (LEDs) to a Raspberry Pi and created an 
animated Christmas tree for the front garden,” 
Greg told us in the email. “This year, we’ve taken 
it up a notch: we’1l be running over 6000 pixels for 
our Xmas Show - still controlled by a Raspberry Pi, 
although connected via dedicated hardware.” 

It’s a spectacular sight, and they even used 
it for Halloween! We love a good project you 
can recycle and repurpose - take a look here: 
magpi.cc/igXcwi. 
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MagP1 Monday 


Amazing projects direct from our Twitter 


very Monday we ask the question: have you & Patrick Fitegerald 
made something with a Raspberry Pi over — 
the weekend? Every Monday, our followers 


send us amazing photos and videos of the things Continued work on a custom vivarium controller for my 
family's pet bearded dragon. 


ying to @TheMagP 


they’ve made. Here is a small fraction of them. 
Follow along at the hashtag #MagPiMonday. 


@ omen 02 
RaspberryPint 
Replying 


@TheMagPi 


Happy Halloween. | am using a RPi Zero W to control a 
jack-o'-lantern. The build includes a 24V mister, a 12V 
computer fan, and 5V neopixels. The fan is turned off 
to build some mist and then turns on to give an angry 
effect of smoke coming out of everywhere. 


01. We're not sure 
what's cooler: the 
applications of 
this project, or the 
bearded dragon logo 


David Rojo 
awed 


to @TheMag?i 


Working on a cabinet @ 


02. Halloween was just 
happening as we 
were released last 
issue, meaning there 
were still some great 
seasonal spooks 

o see 


03. This lovely-looking 
arcade cabinet that 
folds down to be 

stored is wonderful 


04. We love seeing Ted ; 
updates on D . 0a | 
he automated f @TheMag 


mowing robot Continued work on the PiMowBot project. My co a —— 
05. Mike of CamJam and partner on this project has published some nice video a. » to @TheksegPi 

Pi \/ars fame showed tutorials on how to build #3Dprinting #smart #loT - 

off this amazing- #robotics #lawnmower with #RaspberryPi #PiZero. Yep! | worked nny long-gestating robot. It ae 

ooking wooden robot @NéeilRedRobotics motor controller and _now_ it uses a 
You can view all tutorials at pimowbot.tgd- LiPo battery (Rule Zero is obeyed). So, | added an on/off 
consulting.de switch and additional mounting holes to cope with the 

Pi being 90 degrees rotated. 

youtu.be/NdJ2QqNQJe! 


% YouTube 
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Low-Latency Real- 
time Robot Control 
Software Guide 


Less of a product and more documentation, this will give 
you some direction on how to remotely control a robot in 
real time over WiFi. We've done tutorials on stuff like this, 
but this plans to go a bit more in-depth. 


kck.st/2WrbPIH 
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Black Raspberry 


This case designed for a Raspberry Pi 4 does a bit more 
than just keep a Raspberry Pi protected - it also extends 
out the I/O (USB, Ethernet, etc.) toa more classic 
configuration along the ‘rear’ of the case. 


kck.st/2peSisq 


Sound up your 
Raspberry Pi 


BY DErry, com 
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s 


aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry 
Pi-themed events dre happening near you... 


01. Raspberry Pi Jam Mexico 05. Barnstaple Library Raspberry Jam 

© Saturday 30 November © Saturday 14 December 

9 Tenayuca 25, Mexico City, Mexico 9 Barnstaple Library, Barnstaple, UK 

> magpi.cc/3wtTp5 > magpi.cc/LXPaPG 

Acommunity event focused on gathering people who Get together and share ideas with other Raspberry Pi 

want to learn about maker culture. enthusiasts. Everyone welcome. 

02. Leeds Raspberry Jam 06. Cornwall Tech Jam 

& Wednesday 4 December © Saturday 14 December FULL CALENDAR 
9 Dixons Unity Academy, Leeds, UK Q Bodmin Library, Bodmin, UK Get a full list of upcoming 
> magpi.cc/Nnhpgn > cornwalltechjam.uk events for December and 
There'll be chances to get hands-on with more digital For anyone interested in technology, of all beyond here: 
making activities through the workshop, as well as a ages and abilities. Ask questions and learn rpf.io/jam 
hackspace area. about programming. 

03. Exeter Raspberry Jam 07. South Devon Tech Jam 

© Saturday 7 December © Saturday 14 December 

9 Exeter Library, Exeter, UK QY Paignton Library & Information Centre, Paignton, UK 

> magpi.cc/rpep8e > magpi.cc/9vhGQ5 

A meeting for everyone interested in all things computers, A monthly informal and friendly session for anyone 

microcontrollers, robotics, and making. interested in technology, regardless of age or ability. 

04. Stafford Raspberry Jam 08. Raspberry Jam Zelzate 

© Tuesday 10 December © Saturday 21 December 

Q Stafford College, Stafford, UK 9 Openbare Bibliotheek Zelzate, Zelzate, Belgium 

> magpi.cc/3T5aT2 > magpi.cc/agqrW8 

A meet-up for folks who have a Raspberry Pi computer Everyone is welcome to start, share, and work on their own 

and want to learn more about it.. projects in a fun and relaxed atmosphere. 
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FIND OUT 


eo Ye “4 | ABOUT JAMS 
85 & Want a Raspberry Jam 
| ® _ 8 in your area? Want to 
SS 8 6 start one? 
* & 6 F ’ jam@raspberrypi.org 
& *, 
6 


shu 
res) We've highlighted some of the areas & 


in need of a Jam! Can you help out? 


Raspberry Jam advice: 
dd e use the Eventbrite app to check in 
W attendees where possible. However, 


people tend to arrive all at once and we 
don’t like a queue. If it’s not possible to scan the 


tickets, we just check them as they come in. As 2 
It means our numbers are a little off, but it | iy & 
keeps people happier.” y h ~ > > 

2 ¥ WO. 


Michael Horne - Cambridge Raspberry Jam Tad o a 
Ps 


> <t 
“¢ RASPBERRY @ 

Every Raspberry Jam is entitled to apply fora 

Jam starter kit, which includes magazine issues, Ras 


- 
printed worksheets, stickers, flyers, and more. SUIDEBOOK 


Get the book here: rpf.io/guidebook 
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Your & 


Letters 


Project submission 


If I’ve created a project that I 
want to submit to you, what is 
the best way to go about it? 


Nessa vig Twitter 


If you drop us an email at 
magpi@raspberrypi.org, or send 
it to us via Facebook or Twitter, 
we’d be happy to look at putting 
it in the magazine in some form. 
Good pictures are necessary, So 
if you have some taken in decent 
light, that will help. 

Usually, we’ll ask you some 
questions and your project 
ends up in a Project Showcase - 
otherwise we’ll try to squeeze it 
in elsewhere. Websites and info 
about what you have done are 
also very helpful. 


Contact us! 


> Twitter 


@TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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Magri 


A Wehave plenty of new 
books for all your gift needs! 


New books 


I’ve been keeping an eye on your store to see if you have any new 
books coming out this year — you always seem to release a few 
good ones before Christmas! Any chance you could let me know 
if there will be another Official Projects Book or anything else new? 
They’re always good presents. 


Allister via email 


Good news: as the magazine goes to print, we’ve had a few new books 
released. From us folks on The MagPi, there’s the Official Raspberry 
Pi Projects Volume 5, which is 200 pages of Raspberry Pi 4 (and other 
models) goodness. It’s perfect for newbies and people looking for 
what to actually do with their Raspberry Pi. 

In addition, we have a book on Retro Gaming with Raspberry Pi, 
which is another 164 pages of amazing retro-gaming-themed 
projects and tutorials so that you can get your classic gaming fix at 
home or in your pocket. 

We've also updated the Raspberry Pi Beginner’s Guide and released 
a brand new Get Started with Raspberry Pi book that comes witha 
Raspberry Pi 3A+! Plenty to get stuck into. 


© POWERFUL” 


Tnpanr. 
OFFICIAL RASPBERRY Pl MAGAZINE 


TS & TUTORIALS 


40 PAGES OF PROJEC 


A MagPi Christmas 


I want to subscribe to The MagPi 
magazine for my daughter for 
twelve months at the beginning 
of December, but wanted to 
know if she would receive a 
magazine in time for 

Christmas as it will be her gift. 
Could you let me know the date 
of delivery? 


Kim vic email 


As well as this issue, we have one 
other issue coming out before 
Christmas (19 December, see 
more on page 97). So, depending 
on where you live, you will be 
able to subscribe for that issue 
in time — however, to be safe, 
the earlier you subscribe, the 
more likely you’ ll have a copy 

in time as the gift. Make sure to 
check out our subscription offers 
at magpi.cc/subscribe. 
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Cluster of fun 


I like the look of the cluster computing project you did in 
The MagPi, but I do have to ask... what is the point of it? You 
can’t really do much real computing with it. 


Piers via Facebook 


The cluster tutorial is more of a fun thing you can do that helps you 
learn computing. Sure, you’re not going to be able to make a real 
supercomputer out of it, and even with hundreds of Raspberry Pi 
boards it might be a stretch. However, at least you can learn how to 
do it, and the kind of maths you would do with a cluster. 

That being said, we are planning a more in-depth look with what you 
can do with it ina future issue, so watch this space. 


M We are planning a more in-depth look 
at what you can do with a cluster @ 
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robotic arm for Raspberry Pi, 
and get started with robotics 
at your fingertips @ 


We reviewed the PiArm in 
issue 87 of The MagPi and 
found it an impressive piece 
of hardware - now it’s your 


chance to win one. 


In association with 
SB Components 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/E2BWNr 


Terms & Conditions 


Competition opens on 28 November and closes on 19 December 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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A lifelong obsession 


Lucy Hattersley has spent a long time learning to code 


t the base physical level, 
A a computer is ground-up 
rocks that we’ve tricked into 
thinking. It’s the most remarkable 
achievement of the human race; one 
that teaches us what it means to 
be human. 

I believe that learning to code is 
one of the most profound things 
you can do as a human on the planet 
today. Not just because you can get 
a cushy job doing something you 
enjoy; or even because computers 
run the world, so you might as well 
understand how they work (although 
that is important). 

It’s because teaching a machine to 
think helps you contemplate what you 
are. And learning to code (especially 
on a modern computer) means taking 
gigantic, otherworldly concepts and 
breaking them down into small, 
manageable parts. Learn to do that 
with a computer and you can do it all 
kinds of parts of life. Coding makes 
you a better person. 


Learning the BASICs 

All of this was lost to me when | 

first encountered a ZX81 at infant 
school. I remember programming 

a platform game where a 0 had to 
jump up through a moving gap in the 
platform above. 


98 | magpi.cc | Alifelong obsession 


As with most ZX81 games, you could 
only write a couple of screens of code 
before running out of the 1KB RAM. 
This turns out to be a bonus when 
you’ re six years old and would prefer 
to go outside and play. 

As I grew older, I moved on to 
BBC Micro at school and begged 
my parents for a Sinclair Spectrum 


hands of young makers, and they can 

make anything they want with it. 
Computers are more than just 

games consoles with keyboards. A 

good computer has an ecosystem 

of development and making that 

springs up naturally, both from 

the availability of tools and the 

community that grows up around it. 


M We get to work with the best computer 
company in the world @ 


at home. I loved making animated 
stories, simple games, and text 
adventures. Like most children from 
that era, ve paid my parents back 
with a lifetime of free tech support. 


School days 

I remember controlling robotic turtles 
at school, developing my own version 
of Ceefax, and acid-dipping printed 
circuit boards. 

Computing was often mayhem and 
even if things rarely worked, I never 
found the lessons dull. This is one 
reason why I support Raspberry Pi’s 
low-cost endeavours. 

‘It’s not a toy’ is perhaps the 
worst thing a child can hear about 
a computer. But an incredibly well- 
engineered toy can get itself into the 


That community is important. We 
bring together the best people we 
can find and write about the fun stuff 
they’re making, or the cool events 
they’re putting on. We get to work 
with the best computer company in 
the world; on the best computer ever 
made. We have a lot of fun! 

So thank you for putting up with 
me as editor of The MagPi magazine. | 
hope you’ve enjoyed 2019, and 2020 is 
going to be even better. HI 


Lucy Hattersley 


Lucy is editor of The MagPi. She works 
with Rob, Phil, Sam, and lots of writers 
every month to put together this 
magazine and hopes you enjoy it. 


@lucyhattersley 
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Visualize actionable data on 3D 
models from all your Raspberry 
Pi sensors. 


UrsaLeo technology takes Raspberry Pi sensor data and 
displays it on 3D models of any environment, visualizing 


alerts and lending context to help guide your business. 


Y Import your environment with a CAD drawing (Sketch Up, AutoCAD 
or similar) or start with photographs and measurements 


Y Zoom, pan and rotate through a fully rendered 3D model that 
combines your data with our software 


Y Easily place your sensor locations in the environment and define 
metadata for each one 


/Y Define camera viewpoints for each sensor 

¥ Set up alerts based on incoming data 
« Assign status colors to visualize sensor and asset information 
¢« Automatically jump to view any sensor generating an alert 


Y Multiple visualizations available, such as X-ray, rewind and replay, with more coming soon 
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